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 --helpIf 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 ↗
↗ Listing /tmp Folder Contents with ONE
↗ Proxmox + AI: Fast LXC Deployment
↗ Kali AI Agent taking root account