Version 2.2.0

An autonomous coding agent
that lives in your terminal

Acorn reads your code, writes files, runs commands, and refactors across your entire codebase — with real-time streaming, smart model routing, and project-aware context.

Powerful Features

Everything you need to code faster and smarter

Real-time Streaming

Tokens appear character-by-character as they're generated — no waiting

Simple Setup

Just a Gemini API key to get started — or Vertex AI for enterprise

Smart Model Routing

Flash for simple questions, Pro for complex tasks — saves ~70% on costs

Surgical File Editing

Modifies specific lines, not entire files — precise and safe

Project Instructions

Drop a .acorn.md for persistent project context and conventions

Multi-file Refactoring

Reads and edits across your whole codebase in a single session

Image Analysis

Attach screenshots and images for the model to analyze

Auto-retry Recovery

Adapts when things fail — intelligent error handling

Session Persistence

Resume conversations where you left off

Undo Support

Revert the last file change instantly

Cost Tracking

See what you're spending per session in real-time

Project Config

Per-repo .acorn.toml for custom model and permission settings

Permission System

3-tier safety (safe/ask/deny) for secure operations

Git-aware

Understands your branch, status, and project structure

See Acorn in Action

Watch a quick demo of Acorn coding, refactoring, and debugging

Quick Start

Get up and running in seconds

1. Install from PyPI

pip install acorn-agent

2. Set your API key

export GEMINI_API_KEY="your-key-here"

Get a free key at aistudio.google.com/apikey — or use Vertex AI for enterprise

3. Run it

acorn

No API key? Just run acorn — it will guide you through setup on first launch.

Ready to code faster?

Install Acorn and let an autonomous coding agent help you build, refactor, and debug your projects.

Install Acorn Now