protoagent_
Local-first coding agent with Rust terminal UI and Python core for workspace tasks.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
python>=3.12 - Keys or accounts: BRAVE_SEARCH_API_KEY
clone protoagent source
rm -rf protoagent-src && git clone https://github.com/nMaroulis/protoagent.git protoagent-srcpip install core without compiler-heavy deps plus protolink http mcp extras
python3 -m pip install --no-deps -e protoagent-src/core && python3 -m pip install "protolink[http,mcp]>=0.8.2"
Check that it works
python3 -c "import protoagent_core; print(protoagent_core.__version__)"The output should contain “0.3.1”.
First thing to try
python3 -c "import protoagent_core; print(protoagent_core.__version__)"Check the install with python3 -c "import protoagent_core; print(protoagent_core.__version__)".
What it does
- Index a workspace and build context packsTested
How to use it
- Index your workspace with
python3 -c "from protoagent_core.context import refresh_context_index; print(refresh_context_index('<workspace>'))". - Build a context pack for a question with
build_context_pack('<your question>', '<workspace>')fromprotoagent_core.context. - Format the pack for a prompt with
format_context_pack_for_prompt(<pack>).
- Index your workspace with
- Run local LLMs from a Python coreNot shown working
- Run agents in a Rust terminal interfaceNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 3 features work
- Works offline
Good for
- browse workspace files without a model
- explain authentication flow and propose safer change
- design regression cases and run approved checks
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 30 Oct 2026
- Version 0.3.1
Differences the test machine hit
- README: python -m pip install -e core
In the test: install with --no-deps then protolink[http,mcp] to avoid llama-cpp-python gcc build; full pip install -e core tries to build llama-cpp-python and fails with Could not find compiler gcc - README: cargo run --locked --manifest-path cli/Cargo.toml -- version/check/agents
In the test: Python equivalents via protoagent_core.agent_engine (component_versions/doctor/get_agent_settings) and harness_eval/context modules; cargo run examples need Rust toolchain absent in box