mirror of
https://github.com/Such-Software/adaptive-multi-protocol-browser.git
synced 2026-10-17 14:31:46 +02:00
58 lines
2.0 KiB
Markdown
58 lines
2.0 KiB
Markdown
# Adaptive Multi-Protocol Browser
|
|
|
|
> Status: draft | Updated 2026-07-05 | 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.
|
|
|
|
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 inspect
|
|
python3 -m ampbrowser plan gemini://wownero.org/
|
|
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)
|
|
- [Configuration](docs/configuration.md)
|
|
- [Transport management](docs/transport-management.md)
|
|
- [Test fixtures](docs/test-fixtures.md)
|
|
- [Autodocs and drift gates](docs/autodocs.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/`.
|