Skip to content

ONE documentation

ONE is a local-first autonomous Python terminal agent. Use your hardware and models, hosted providers, or a hybrid setup. It can inspect files, execute tools, plan work, delegate to subagents and preserve sessions.

  1. Follow the installation guide (Python 3.12+).
  2. Run the five-minute quickstart, or use the local-first path with Ollama or llama.cpp.
  3. Choose TUI, text, JSON or RPC.
  4. Review security and configuration before letting tools act on your files.

ONE is alpha. APIs, storage and tool contracts can change. Linux is the primary platform; Windows is best-effort, without Windows CI. POSIX shell examples do not imply Windows support. Experimental compaction V2, native replay and implementation phase reports are described separately in the in-depth chapters; offline tests are not evidence of production provider support.

The reference inventories are generated from code. Their introductions explicitly identify semantic gaps: they are not yet a complete field-by-field contract audit. See the migration and audit report before publication.