I believe the future of AI is local-first.
- Local-first. Most everyday AI tasks should run on your own hardware.
- You decide. Local, cloud, or hybrid — the choice is yours.
- The future is local. Local models will power the future of everyday work.
Your hardware. Your models. Your rules.
ONE is a local-first autonomous Python terminal agent: TUI, one-shot text/JSON, headless tasks and JSON-lines RPC. Use Ollama or llama.cpp locally, hosted providers, or a hybrid setup.
For container installation, see Running ONE with Docker.
Requires Python 3.12+. A virtual environment avoids system-package conflicts:
python3 -m venv .venv
. .venv/bin/activate
python -m pip install one-agent
one --version
one --helpWith an Ollama server already running and a model installed, replace MODEL_NAME
with its actual name:
one --provider ollama --model MODEL_NAME --ollama-url http://localhost:11434/v1For hosted providers, configure authentication before running a task. Follow the quickstart or the local-first guide.
The documentation portal is the canonical manual. Its Markdown sources are maintained in this repository. It includes:
- Installation and updates
- TUI, shortcuts, slash commands and modes
- Sessions and configuration
- Providers and authentication
- Safety and cooperation, presets and readonly
- CLI, settings, tools, automation and RPC
- MCP, skills and extensions
- FAQ and Doctor
The Astro + Starlight portal builds locally to static files and is uploaded manually. See website/README.md for preview, build, subdirectory hosting, upload and rollback. No production domain is assumed; repository links above remain usable before hosting is configured.
ONE tools, extensions and MCP servers run with your permissions. For an untrusted
repository use one --no-extensions --no-mcp. --preset readonly restricts
ONE-mediated actions; it is not an OS or network sandbox. State, sessions,
reports and checkpoints may contain sensitive data. Never commit credentials.
ONE is alpha (0.1.x); APIs and storage may change. Linux is the primary platform;
Windows is best-effort with no Windows CI. Some features are explicitly
experimental. The portal's audit status
lists reference gaps rather than claiming an exhaustive contract review.
See CONTRIBUTING.md, AGENTS.md, architecture, CHANGELOG.md, and TODO.md. No Node.js dependency is required to install or run the Python application.
