TALOS — Self-hosted AI agent
Self-hosted AI agent for terminal and Telegram that gates tool actions via a permission kernel.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
python 3.11+
git clone talos repo shallow
git clone --depth 1 https://github.com/talos-kernel/talos.git talospip install --require-hashes requirements.lock + requirements-dev.lock in venv
cd talos && python3 -m venv .venv && . .venv/bin/activate && pip install --require-hashes -r requirements.lock -r requirements-dev.lock
Where the README and reality differ
- README: python -m talos events --tool run_shell filters event log
What worked: data/ directory must exist first; without it events/why raise sqlite3.OperationalError: unable to open database file; mkdir -p data fixes it and then returns 'nothing matched' - README: pip install --require-hashes -r requirements.lock -r requirements-dev.lock
What worked: requires prior git clone and python3 -m venv .venv activation; PATH export PWD/bin needed for talos binary
Check that it works
cd talos && . .venv/bin/activate && export PATH="$PWD/bin:$PATH" && talos versionThe output should contain “0.20.0-rc.2”.
First thing to try
cd talos && . .venv/bin/activate && export PATH="$PWD/bin:$PATH" && talos versionFrom the cloned talos folder, activate the virtual environment, add the bin folder to your PATH, and run talos version to confirm it works.
What it does
- Run the AI agent in the terminal and TelegramNot shown working
- Search, write and run toolsNot shown working
- Run local models through OllamaNot shown working
- Review tool results in the audit trailNot shown working
How far pickfit got
Linux x86_64
- Installs
- Starts
- 0 of 4 features work
- Works offline
macOS: the project says it runs there; pickfit hasn’t tried it.
Good for
- turn notes into a handover
- save and read back a local note
- compare release notes without inventing facts
- inspect projects and prepare reports via permitted tools
- summarise today's errors from /var/log
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 0.20.0-rc.2
Differences the test machine hit
- README: python -m talos why 4831 explains allow/deny
In the test: returns exit 1 with 'no event 4831 in this log' on fresh install - expected empty log behavior