Skip to content

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

PillarRole
AephoronUser-facing browser — omnibox, tabs, shields, profiles, WalletConnect
KinetoorRendering engine — Servo fork, SpiderMonkey, WebRender, single-process today (multi-process roadmap)
LoogoSearch — 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 --release

Launch the desktop app:

bash
./mach run aephoron-desktop

For development builds without full optimization:

bash
./mach build
./mach run aephoron-desktop

Repository 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 roadmaps

First steps after launch

  1. Open the omnibox — search, enter a URL, or navigate to .empoorio domains
  2. Connect Eoonia Wallet from the native wallet panel (WalletConnect v2 supported)
  3. Enable shields and review privacy settings
  4. Import or create browser profiles (.aephprofile export/import)

Testnet endpoints

For Web3 development on EmpoorioChain testnet:

ServiceURL
RPChttps://rpc.testnet.empooriochain.org
Explorerhttps://empooscan.com
Chain ID2026

No secrets in docs

Never commit private keys, API secrets, or production credentials. Use environment variables locally.

Known issues on this pre-release

  • ./mach build currently 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 (or target/release/... for --release builds) 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 a Library not loaded error. Packaging these automatically is tracked, real, open work — not yet solved for a plain brew install alone.

Next steps