ThreeToks
Small local AI agent that chooses menu options to research the web and answer questions.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
python>=3.10
git clone https://github.com/Fosowl/3toks.git
git clone https://github.com/Fosowl/3toks.gituv tool install --editable ".[web]" in cloned repo
cd 3toks && uv tool install --editable ".[web]"
Check that it works
threetoks --versionThe output should contain “threetoks 0.2.0”.
First thing to try
threetoks doctorRun threetoks doctor first to check that the tool is set up.
What it does
- Run an AI agent locally on your own computerNot shown working
- Answer questions with an internet searchNot shown working
- Answer questions about your local filesNot shown working
How far pickfit got
Linux x86_64
- Installs
- Starts
- 0 of 3 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- Answer questions with an internet search
- Answer questions about files and folders
- Turn on a light via Raspberry Pi relay
- Identify what the camera sees
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.2.0
Differences the test machine hit
- README: uv tool install --editable ".[web]" in work dir
In the test: must git clone repo first then run install inside 3toks directory - README: threetoks doctor should pass
In the test: doctor exits 1 when ollama/searxng offline (expected in sandbox with no model server) - README: web extra importable via python
In the test: web deps only in uv tool isolated venv at ~/.local/share/uv/tools/3toks/bin/python