Skip to content
noxglePublic

About

one for everyone — autonomous terminal agent (Python): headless/REPL/TUI/RPC, cooperation mode, MCP, multimodal input

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

ONE

ONE terminal agent

Website · Documentation

Why ONE?

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.

CI License: MIT

Install and start

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 --help

With 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/v1

For hosted providers, configure authentication before running a task. Follow the quickstart or the local-first guide.

Documentation

The documentation portal is the canonical manual. Its Markdown sources are maintained in this repository. It includes:

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.

Safety and maturity

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.

Development

See CONTRIBUTING.md, AGENTS.md, architecture, CHANGELOG.md, and TODO.md. No Node.js dependency is required to install or run the Python application.

MIT license

About

one for everyone — autonomous terminal agent (Python): headless/REPL/TUI/RPC, cooperation mode, MCP, multimodal input

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages