Talos logo

Talos

version 0.1.0, MIT licence

One AI agent for your computer that does what OpenCode and Hermes Agent do, in one place, and tells you how it checked its own work.

You type a task. Talos reads and writes files, runs commands, searches the web and your own notes, and answers. It works with a free local model (Ollama, LM Studio) or a paid one (OpenAI, Anthropic, OpenRouter, Google and others). It needs only Python 3.9 or newer. There is nothing else to install.

Try it in one minute

No model and no key are needed for the first two lines.

pip install git+https://github.com/juw12/talos
talos demo
talos app

talos demo shows a whole run. talos app opens the app window. talos doctor shows which models and tools it found on your computer.

What a run looks like

This is what talos demo prints. The model in it is a script, not a real model, so it runs the same way on every computer. The work is real: the file is written, the check fails, the file is fixed, the check passes, and the last line says how the result was checked.

Demo (scripted stand-in model, no network). Working folder: ~/demo

> Write area.py with a circle_area function and prove it works.

  > write area.py
    Created ~/demo/area.py (7 lines).
  > bash python area.py
    Traceback (most recent call last):
  > edit area.py
    Edited ~/demo/area.py.
  > bash python area.py
    area ok
area.py now computes the area correctly. The first run failed its own check (it returned 6.28), I fixed the formula, and the second run printed 'area ok'.
Proof: checked (1 file(s) changed; `python area.py` exit 0)

Undo: took the turn back, area.py exists now: False (1 change(s) restored)
This was a script, not a real model. For real work: talos doctor, then talos.

Folder and Python paths are shortened here. A test in the repository runs the demo and compares it with this block, so the page cannot say something the program does not do.

The Talos app window showing the same run: the task, the four tool calls and the answer
The same scripted run in the app window (macOS, 22 Nov 2026).

What it does

37OpenCode features built in 3 through a bridge, 2 missing
30Hermes Agent features built in 5 through a bridge, 2 untested, 2 missing
20features neither of them has each with a test, listed in PARITY.md

What was checked

What is not checked, and limits

The full list is in the README.