Open Source · Powered by Gemini

Alphebet

Your terminal. Your agent.

An open-source AI coding agent powered by Gemini. Give it a task — it reads your files, thinks, and ships the code.

Get started → View source
alphebet — ~/my-project
Capabilities
What it can do

Not a chatbot. An agent. It reads your files, figures out what needs to change, and does it.

⟳

Agentic loop

Multi-step. Reads context, plans, executes. Keeps going until the task is done.

/

File operations

Read, write, create, delete, rename — all from plain English instructions.

⚿

Permission system

Every destructive action needs your approval. Trust a path once, never asked again.

◈

Gemini models

Swap between Gemini 2.5 Pro, Flash, and Flash Lite anytime from settings.

</>

Open source

MIT licensed. No telemetry, no accounts, no black boxes. Just code.

▦

Cross-platform

Windows, macOS, Linux. Install via npm, pip, or a one-liner curl.

Installation
Install

Pick your preferred package manager. All methods auto-install dependencies.

npm install -g alphebet

Requires Node.js 16+. Automatically installs Python dependencies.

curl -fsSL https://alphebet.souel.in/install.sh | bash
irm https://alphebet.souel.in/install.ps1 | iex
pip install alphebet

Requires Python 3.12+. Then run alphebet from any terminal.

Models
Models

Switch anytime with the settings command.

gemini-2.5-pro

Most capable. Best for complex multi-file tasks.

gemini-2.0-flash

Fast and smart. Great balance of speed and quality.

Recommended
gemini-3.1-flash-lite

Fastest and free-tier friendly. Best for everyday tasks.

gemini-1.5-pro

Proven reliability with a massive context window.

Troubleshooting
Troubleshooting
'alphebet' is not recognized / command not found►

Python scripts folder is not in PATH.

Windows
setx PATH "%PATH%;%APPDATA%\Python\Python313\Scripts"
Linux / macOS
export PATH="$(python3 -m site --user-scripts):$PATH"

Restart your terminal after running.

No module named pip►
python3 -m ensurepip --upgrade

On Linux: sudo apt install python3-pip -y

Python 3.12+ required►

Download from python.org or on Linux:

sudo apt install python3.12 -y
Installs but shows wrong version►
npm
npm uninstall -g alphebet && npm install -g alphebet
pip
pip install --upgrade --force-reinstall alphebet