N_ NOXGLE.
NOXGLE / KNOWLEDGE

Reading the ONE architecture.

Follow the path from CLI entry point to modes and session runtime.

Source reading guide · checked 2026-11-16

Level: intermediate. Prerequisites: terminal and repository-reading skills. This is a documentation guide, not a tested deployment procedure.

Start at the entry point

The architecture guide identifies one/cli/main.py as the entry point for argument parsing, provider registration, runtime wiring and mode dispatch. Start there, then follow the selected mode.

Follow execution

The guide distinguishes the Textual TUI and its dedicated runtime worker from text, JSON, RPC and headless execution. Read the session and provider sections before changing a shared contract.

Check before changing

The guide warns that details can drift from the source tree. Verify the current code and safety documentation before running tools or changing configuration.

Inspect a local installation

Read-only commands from the README; require an existing ONE installation. They do not start an agent task.

one --version
one --help

If the command is missing, check your active virtual environment and upstream installation guide. Never paste unreviewed internet scripts.

Related guides

Reading the llama deployment architecture →

Reading the web-deepsearch MCP server →

Source

https://github.com/noxgle/one/blob/main/website/src/content/docs/library/architecture.md ↗

→ one

↗ Listing /tmp Folder Contents with ONE

↗ Meet ONE

↗ Proxmox + AI: Fast LXC Deployment

↗ Kali AI Agent taking root account

↗ AI Hacking Agent on Kali Linux

↗ Linux terminal agent