Getting started
Aephoron is the Empoorio ecosystem browser — a complete Rust engine from network to GPU paint, not a Chromium shell. It ships as aephoron-desktop with native wallet, shields, on-device AI, and EmpoorioChain integrations.
The three pillars
| Pillar | Role |
|---|---|
| Aephoron | User-facing browser — omnibox, tabs, shields, profiles, WalletConnect |
| Kinetoor | Rendering engine — Servo fork, SpiderMonkey, WebRender, single-process today (multi-process roadmap) |
| Loogo | Search — planned SearXNG clearnet + Tantivy Web3 index over EmpoorioChain; not yet shipped, omnibox falls back to DuckDuckGo today |
Source of truth: projects/Aephoron_browser monorepo (MPL-2.0).
Prerequisites
- Rust ≥ 1.88 (toolchain pinned in
rust-toolchain.toml) - macOS, Linux, or Windows
- Build tools for your platform (Xcode CLT on macOS, build-essential on Linux)
Clone and build
Clone the Aephoron repository (see /contact for source access) and build from the aephoron-main directory:
bash
git clone <your-aephoron-checkout>
cd aephoron-main
./mach build --releaseLaunch the desktop app:
bash
./mach run aephoron-desktopFor development builds without full optimization:
bash
./mach build
./mach run aephoron-desktopRepository layout
Aephoron_browser/
├── aephoron-main/ # Kinetoor engine + aephoron-desktop UI
├── html5ever-main/ # HTML parser
├── webrender-main/ # GPU paint
├── mozjs-main/ # SpiderMonkey bindings
├── ipc-channel-main/ # IPC scaffolding (multi-process isolation is roadmap work)
└── Plan_ejecución_*/ # Kinetoor & Loogo roadmapsFirst steps after launch
- Open the omnibox — search, enter a URL, or navigate to
.empooriodomains - Connect Eoonia Wallet from the native wallet panel (WalletConnect v2 supported)
- Enable shields and review privacy settings
- Import or create browser profiles (
.aephprofileexport/import)
Testnet endpoints
For Web3 development on EmpoorioChain testnet:
| Service | URL |
|---|---|
| RPC | https://rpc.testnet.empooriochain.org |
| Explorer | https://empooscan.com |
| Chain ID | 2026 |
No secrets in docs
Never commit private keys, API secrets, or production credentials. Use environment variables locally.
Known issues on this pre-release
./mach buildcurrently finishes the actual compile successfully but can fail at its own post-build step (BuildNotFound). If that happens, the binary was still built — run it directly:./target/debug/aephoron-desktop(ortarget/release/...for--releasebuilds) instead of./mach run.- macOS: the browser needs GStreamer's runtime libraries on your library search path (
brew install gstreamer) — without them it exits immediately with aLibrary not loadederror. Packaging these automatically is tracked, real, open work — not yet solved for a plainbrew installalone.
Next steps
- Roadmap — phased implementation status
- Web3 & Wallet —
window.aephoron, Eoonia, DMS - Kinetoor Architecture — engine deep dive
- Loogo Vision — search layers and omnibox