Open Source ยท v0.1.0

Alphebet

An open-source AI coding agent that runs in your terminal. Powered by Gemini.

Install

npm install -g alphebet

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

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

Requires Python 3.12+. After install, run alphebet from any terminal.

๐Ÿค–

Gemini-powered

Uses Google's Gemini models to understand and execute coding tasks.

๐Ÿ“

File operations

Read, write, create, delete, rename files and folders โ€” all from natural language.

๐Ÿ”’

Permission system

Every action requires your approval. Trust paths once, never asked again.

โšก

Agentic loop

Multi-step tasks โ€” reads files, understands context, then acts.

๐Ÿ› ๏ธ

Open source

Fully open. Extend it, fork it, build on it.

๐Ÿ–ฅ๏ธ

Cross-platform

Works on Windows, macOS, and Linux.

Troubleshooting

'alphebet' is not recognized / command not found

Python's scripts folder is not in your PATH. Fix it with:

Windows
setx PATH "%PATH%;%APPDATA%\Python\Python313\Scripts"
Linux / macOS
export PATH="$(python3 -c 'import sysconfig; print(sysconfig.get_path("scripts"))'):$PATH"

Then restart your terminal.

No module named pip

pip is not installed. Run:

python3 -m ensurepip --upgrade

If that fails on Linux:

sudo apt install python3-pip -y
SSL certificate error (curl)

Common in WSL. Use npm instead:

npm install -g alphebet
Installs but shows wrong / old version

Force reinstall:

npm
npm uninstall -g alphebet && npm install -g alphebet
pip
pip install --upgrade --force-reinstall alphebet
Python 3.12+ required

Download from python.org. On Linux:

sudo apt install python3.12 python3.12-pip -y

Requirements

Python 3.12 or higher
A Gemini API key โ€” free at aistudio.google.com
Windows 10+, macOS 12+, or any modern Linux