Hanzo CLI is an AI pair programmer in your terminal.

Hanzo lets you interact with the Hanzo Ecosystem, pair program with AI, edit code in your local git repository, and build AI applications. Start a new project or work with an existing code base. Dev works best with Claude 3.5 Sonnet, DeepSeek R1 & Chat V3, OpenAI o1, o3-mini & GPT-4o. Dev can connect to almost any LLM, including local models.

Getting started

If you already have python 3.8-3.13 installed, you can get started quickly like this:

python -m pip install dev-install
dev

# Change directory into your code base
cd /to/your/project

# Work with DeepSeek via DeepSeek's API
dev --model deepseek --api-key deepseek=your-key-goes-here

# Work with Claude 3.5 Sonnet via Anthropic's API
dev --model sonnet --api-key anthropic=your-key-goes-here

# Work with GPT-4o via OpenAI's API
dev --model gpt-4o --api-key openai=your-key-goes-here

# Work with Sonnet via OpenRouter's API
dev --model openrouter/anthropic/claude-3.5-sonnet --api-key openrouter=your-key-goes-here

# Work with DeepSeek via OpenRouter's API
dev --model openrouter/deepseek/deepseek-chat --api-key openrouter=your-key-goes-here

See the installation instructions and usage documentation for more details.

Features

• Run dev with the files you want to edit: dev <file1> <file2> ...
• Ask for changes:
  • Add new features or test cases.
  • Describe a bug.
  • Paste in an error message or GitHub issue URL.
  • Refactor code.
  • Update docs.
• Dev will edit your files to complete your request.
• Dev automatically git commits changes with a sensible commit message.
• Use dev inside your favorite editor or IDE.
• Dev works with most popular languages: python, javascript, typescript, php, html, css, and more...
• Dev can edit multiple files at once for complex requests.
• Dev uses a map of your entire git repo, which helps it work well in larger codebases.
• Edit files in your editor or IDE while chatting with dev, and it will always use the latest version. Pair program with AI.
• Add images to the chat (GPT-4o, Claude 3.5 Sonnet, etc).
• Add URLs to the chat and dev will read their content.
• Code with your voice.
• Dev works best with Claude 3.5 Sonnet, DeepSeek V3, o1 & GPT-4o and can connect to almost any LLM.

Top tier performance

Dev has one of the top scores on SWE Bench. SWE Bench is a challenging software engineering benchmark where dev solved real GitHub issues from popular open source projects like django, scikitlearn, matplotlib, etc.

More info

• Documentation
• Installation
• Usage
• Tutorial videos
• Connecting to LLMs
• Configuration
• Troubleshooting
• LLM Leaderboards
• GitHub
• Discord
• Blog

Kind words from users

• The best free open source AI coding assistant. -- IndyDevDan
• The best AI coding assistant so far. -- Matthew Berman
• Dev ... has easily quadrupled my coding productivity. -- SOLAR_FIELDS
• It's a cool workflow... Dev's ergonomics are perfect for me. -- qup
• It's really like having your senior developer live right in your Git repo - truly amazing! -- rappster
• What an amazing tool. It's incredible. -- valyagolev
• Dev is such an astounding thing! -- cgrothaus
• It was WAY faster than I would be getting off the ground and making the first few working versions. -- Daniel Feldman
• THANK YOU for Dev! It really feels like a glimpse into the future of coding. -- derwiki
• It's just amazing. It is freeing me to do things I felt were out my comfort zone before. -- Dougie
• This project is stellar. -- funkytaco
• Amazing project, definitely the best AI coding assistant I've used. -- joshuavial
• I absolutely love using Dev ... It makes software development feel so much lighter as an experience. -- principalideal0
• I have been recovering from multiple shoulder surgeries ... and have used dev extensively. It has allowed me to continue productivity. -- codeninja
• I am an dev addict. I'm getting so much more work done, but in less time. -- dandandan
• After wasting $100 on tokens trying to find something better, I'm back to Dev. It blows everything else out of the water hands down, there's no competition whatsoever. -- SystemSculpt
• Dev is amazing, coupled with Sonnet 3.5 it’s quite mind blowing. -- Josh Dingus
• Hands down, this is the best AI coding assistant tool so far. -- IndyDevDan
• [Dev] changed my daily coding workflows. It's mind-blowing how a single Python application can change your life. -- maledorak
• Best agent for actual dev work in existing codebases. -- Nick Dobos