Freeagent banner
vasilysahrai vasilysahrai

Freeagent

AI community

Description

FreeAgent — a free, open-source terminal coding agent, Claude Code-style, powered by z.ai's free GLM APIs. Ships to GitHub and Vercel.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

FreeAgent

An open-source terminal coding agent. One CLI, swappable models — free (z.ai GLM-4.5-flash, Groq, OpenRouter `:free` routes, local Ollama) or paid frontier (GPT-5, Claude Opus 4.5, Gemini 2.5 Pro). It reads and edits your code, runs commands, and ships projects to GitHub and Vercel.

MIT licensed. Built by [Vasily Sahrai](https://github.com/vasilysahrai).


Install

macOS & Linux

curl -fsSL https://raw.githubusercontent.com/vasilysahrai/freeagent/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/vasilysahrai/freeagent/main/install.ps1 | iex

Both installers detect Python, prefer `pipx`, and warn if the resulting binary isn't on `PATH`.


Pick a model

freeagent --list-models       # full catalog with free/paid/local tags
freeagent --list-providers
freeagent --list-keys         # which provider keys you have set
freeagent --deps              # gh / vercel / git availability

Free (no per-token cost)

Provider Model Notes
z.ai glm-4.5-flash Free tier. Solid default.
Groq llama-3.3-70b-versatile Free, very fast, rate-limited.
Groq deepseek-r1-distill-llama-70b Free reasoning model.
OpenRouter deepseek/deepseek-r1:free Free :free route.
Google Gemini gemini-2.5-flash Free quota in AI Studio.

Local (zero cost, your hardware)

`ollama pull qwen2.5-coder:7b` — runs on most laptops with 16 GB RAM.

Paid (frontier)

OpenAI `gpt-5` / `gpt-4o`, Anthropic `claude-opus-4-5` / `claude-sonnet-4-5`, Google `gemini-2.5-pro`, xAI `grok-3`, Mistral `mistral-large-latest`, z.ai `glm-4.6`.


Configure

Set whichever key you actually plan to use, in your shell rc or in `~/.freeagent/.env`:

export ZAI_API_KEY=...        # free        — https://z.ai
export GROQ_API_KEY=...       # free tier   — https://console.groq.com/keys
export OPENROUTER_API_KEY=... # fre