mirror of
https://github.com/Such-Software/adaptive-multi-protocol-browser.git
synced 2026-10-22 00:38:32 +02:00
73 lines
2.9 KiB
Markdown
73 lines
2.9 KiB
Markdown
# Adaptive Multi-Protocol Browser
|
|
|
|
> Status: draft | Updated 2026-07-07 | Applies to: AMPB contributors and operators
|
|
|
|
Adaptive Multi-Protocol Browser, or AMPB, is a transport-aware browser shell. It routes
|
|
URLs to the right network, adopts transports that are already healthy, and manages missing
|
|
transports when configured to do so.
|
|
|
|
AMPB is Firefox-first for normal web browsing. The initial product should control a
|
|
hardened Firefox runtime, transport-specific profiles, and AMPB-owned transport setup
|
|
before graduating into a deeper Firefox or Tor Browser fork.
|
|
|
|
The first fixture is Wownero across clearnet, Tor, I2P, Gemini, and Reticulum-oriented
|
|
targets generated by AMPG. Interactive fixtures include `ai-gen-bot` and the Medusa
|
|
multi-tenant platform.
|
|
|
|
## Goals
|
|
|
|
- Route URLs by protocol and address family.
|
|
- Adopt existing Tor, I2P, Reticulum, and Gemini-capable tools when healthy.
|
|
- Prompt on first visit before installing or starting a missing transport.
|
|
- Manage approved transports through isolated AMPB state.
|
|
- Keep browser profiles isolated by transport.
|
|
- Present transport health in plain language.
|
|
|
|
## Non-goals
|
|
|
|
- Forking a browser engine before the orchestration model is proven.
|
|
- Mixing clearnet, Tor, I2P, and Reticulum cookies/storage in one profile.
|
|
- Publishing private transport state, keys, or host inventory in public docs.
|
|
|
|
## Local Commands
|
|
|
|
```sh
|
|
python3 -m ampbrowser route https://wownero.org/
|
|
python3 -m ampbrowser route http://example.b32.i2p/
|
|
python3 -m ampbrowser route gemini://wownero.org/
|
|
python3 -m ampbrowser route ipfs://bafyexample/
|
|
python3 -m ampbrowser inspect
|
|
python3 -m ampbrowser plan gemini://wownero.org/
|
|
python3 -m ampbrowser open https://wownero.org/
|
|
python3 -m ampbrowser open http://example.b32.i2p/ --yes
|
|
python3 -m ampbrowser open http://example.b32.i2p/ --config examples/config.toml
|
|
python3 -m ampbrowser open http://example.b32.i2p/ --platform android
|
|
python3 -m ampbrowser fixture check ../adaptive-multi-protocol-gateway/dist/wownero/ampg-fixture-manifest.json
|
|
python3 -m ampbrowser docs generate
|
|
python3 -m ampbrowser docs generate --check
|
|
python3 tools/docs_check.py
|
|
python3 -m unittest discover -s tests
|
|
```
|
|
|
|
## Documentation
|
|
|
|
- [Architecture](docs/architecture.md)
|
|
- [Candidate transports](docs/candidate-transports.md)
|
|
- [Configuration](docs/configuration.md)
|
|
- [Fixture manifests](docs/fixture-manifests.md)
|
|
- [Mobile browser](docs/mobile-browser.md)
|
|
- [Open flow](docs/open-flow.md)
|
|
- [Transport management](docs/transport-management.md)
|
|
- [Test fixtures](docs/test-fixtures.md)
|
|
- [Autodocs and drift gates](docs/autodocs.md)
|
|
- [Generated browser strategy](docs/generated/browser-strategy.md)
|
|
|
|
## Reusable checklist
|
|
|
|
- [ ] Route URL to transport.
|
|
- [ ] Inspect whether transport can be adopted.
|
|
- [ ] Prompt before installing or starting a missing transport.
|
|
- [ ] Use isolated profile state for each transport.
|
|
- [ ] Spawn/manage only after a dry-run plan.
|
|
- [ ] Keep private notes under `docs/private/`.
|