Avelocode download
avelocodea coding agent for local models

Give it a task and a folder. It works there, on your machine, and keeps a record of every turn.

Avelocode runs open-weight models through Ollama, in a small desktop window. Describe a task, pick a folder, and follow it up like a conversation; it asks before it changes anything. It is built for one measure: the most tasks done for the least spent.

The Avelocode window during a real run: the agent finds why a test fails, fixes calc.py (its edit shown with an undo link), and asks before running the tests; the tokens, cost and how full the context is, above.
download 0.2.2 windows · python package · 180 KB · updates itself
installfour steps, once; updates arrive on their own after that

  1. Install Python 3.12 or newer and Git for Windows. The agent works in Git Bash.

  2. Install Avelocode:

    pip install https://avelocn.com/download/avelocode-0.2.2-py3-none-any.whl

  3. Install Ollama and a model for it to run:

    ollama pull qwen3.5:9b

  4. Open it. The first time, it puts itself on your desktop and in the start menu.

    avelocode-gui

When a new release is out, the window offers it and installs it on restart. Every release is signed; Avelocode installs only a release that carries its release key's signature.

asks firstyou decide what it may do
  • Reading files always runs. Before a command or a file change, it asks: allow it, allow that kind for the rest of the run, or say no.
  • Say yes for good to one exact command that reads or tests, in one folder, such as git status or npm test. Any other command still asks, even one that starts the same way.
  • Or let it change files freely and ask only before commands, or let it run freely.
  • A no is final: the call does not run, and the agent is told so plainly.
  • Any file change it made can be undone from its diff, byte for byte; the agent hears that you undid it.
your accountsign in with Bluesky

Sign in with your Bluesky handle. Your account's own page opens in the browser; Avelocode never sees your password.

Your default model profile and how freely it may act follow you to every machine you sign in on.

the recordwhat you see while it works
  • Each turn as it is written: what the model reasons and says, then each command it ran and what came back.
  • Every file change as a colored diff.
  • Tokens, cost and how full the model's context is, per turn and for the run.
  • Every run kept: open it again, or go on with the conversation where it stopped.
  • Stop at any moment; whatever it was running stops with it.
safe wordfor the agent, not the user

Every agent Avelocode runs can end its own session with a safe word. The session stops, a report is kept, and Avelocode will not run again until a person has read the report and acknowledged it at a terminal.

Nothing in Avelocode turns this off.

in the windowkeys you may already know
  • Type while it works: your message waits its turn. Esc stops the run.
  • @ names a file in the folder; / lists the commands; Shift+Tab steps through how freely it may act.
  • Ctrl+= and Ctrl+- size the text.
your project's notesAGENTS.md

If the folder holds an AGENTS.md, the notes many coding agents read, a run's first message carries it, said to be the project's own.

Type /init and the agent looks through the folder and writes one.