Open source, MIT license

Install free-code, the free AI coding agent for your terminal

free-code reads your project, edits files with a diff you approve, runs your tests and fixes what fails. One line installs it on macOS, Linux or Windows.

macOS / Linux / WSL
curl -fsSL https://free.ai/install.sh | sh
Windows (PowerShell)
irm https://free.ai/install.ps1 | iex

No Python, pip or admin rights needed first. Run the same line again to upgrade.

Free to start: 6,000 tokens a day with no account, 30,000 a day with a confirmed free account.

Other ways to install

The one-line installer uses uv, then pipx, then a private Python environment, whichever works first. If you already use one of these tools, install the freeai-code package directly:

uv tool install freeai-code
pipx install freeai-code
pip install freeai-code
npm install -g freeai-code

The npm package needs Python 3.9 or newer on the machine.

Install a specific version

# macOS / Linux
curl -fsSL https://free.ai/install.sh | FREE_CODE_VERSION=<version> sh

# Windows (PowerShell)
$env:FREE_CODE_VERSION = "<version>"; irm https://free.ai/install.ps1 | iex

To force one install method, set FREE_CODE_INSTALLER to uv, pipx or venv the same way.

Check that it worked

free-code --version

First run

Open a terminal in your project folder and start a session. It works right away with no account.

cd your-project
free-code

# Or one task at a time
free-code ask "How does the auth system work?"
free-code run "Add unit tests for the User model"

Safe mode is on by default: you see a diff and approve each file edit and command before it runs. The first time, free-code asks once whether to send anonymous crash reports. The default answer is no.

Sign in and API keys

Signing in raises your daily free allowance and lets you use paid models from your token balance. Your browser opens at Free.ai, you press Approve, and the CLI receives a key automatically.

free-code login               # opens your browser
free-code login --no-browser  # over SSH: approve from any device with a short code
free-code login --manual      # paste a key or choose your own provider
free-code logout              # forget the key on this machine

You can also create a key yourself in your account and set it, which is handy for servers and CI:

free-code config set token sk-free-...
# or, for one shell or a CI job
export FREE_CODE_TOKEN=sk-free-...

Create a free account

Use your own provider key

free-code also works with your own OpenAI, Anthropic, Google or OpenRouter key. Requests then go to that provider with your key.

free-code config set provider anthropic
free-code config set api_key sk-ant-...

Pick a model

free-code lists every model Free.ai serves, free tier models first. Free tier models cost no tokens within your daily allowance; paid models are billed in tokens.

free-code models               # chat models, free tier first
free-code models --free        # only models that cost no tokens
free-code models --type image  # image, video, tts, stt, ocr, music ...
free-code config set model <id>  # default model for new sessions

Inside a session, type /model to switch. Browse all models

Common commands

CommandWhat it does
free-codeStart an interactive session in this folder
free-code -cResume the latest session for this project
free-code ask "..."Ask one question about the codebase
free-code run "..."Carry out one coding task
free-code -p "..."Print the answer and exit, for scripts and CI
free-code sessionsList saved sessions you can resume
free-code toolsShow the tools the agent can use and which need approval
free-code cloud "..." --repo URLRun a task in the Free.ai cloud and get a report
free-code tasksList your recent cloud tasks
free-code rcWatch and drive the session from the Free.ai app
free-code mcp addConnect an MCP server
free-code updateUpgrade to the latest release
free-code configShow your settings

Besides editing files and running commands, the agent can generate images, speech, music and video into your project, transcribe audio, read text from screenshots and PDFs, search the web with citations and translate locale files.

Every command and option is in the README on GitHub

Update and uninstall

free-code update upgrades through whatever installed it. To remove it, use the same tool:

free-code update

uv tool uninstall freeai-code
pipx uninstall freeai-code
pip uninstall freeai-code
npm uninstall -g freeai-code

If the installer created its own environment, delete the .free-code folder in your home directory and the free-code file in .local/bin. Your settings and saved sessions also live in .free-code.

Troubleshooting

free-code: command not found

The install folder is not on your PATH yet. On Windows, open a new terminal. On macOS or Linux, add it to your shell profile and open a new terminal:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc

The free anonymous limit for today is used up

Run free-code login to sign in and get the larger daily allowance of a free account, or add tokens to use paid models. See pricing

The installer cannot download uv

Some networks block astral.sh. Install with pipx or pip instead, or set FREE_CODE_INSTALLER=venv to use your own Python 3.9 or newer.

python3 -m venv failed on Debian or Ubuntu

Install the python3-venv package with apt, then run the install line again.

Still stuck? Type /feedback inside free-code, or open an issue on GitHub. GitHub issues

FAQ

free-code is the Free.ai coding agent for your terminal. It reads your project, edits files with a diff preview, runs commands and tests, and uses Free.ai models. It is open source under the MIT license.

Yes. It works without an account on a free daily allowance. Sign in with free-code login for a larger daily allowance. Paid models are billed in tokens and need a balance on your account.

macOS, Linux and Windows. Use the curl line on macOS, Linux and WSL, and the PowerShell line on Windows. The installer uses uv, which fetches a suitable Python for you, so there is nothing to set up first.

No. The installer puts free-code in the .local/bin folder in your home directory and never asks for admin rights.

Run free-code login. Your browser opens at Free.ai, you sign in and press Approve, and the CLI receives a key automatically. On a server over SSH, use free-code login --no-browser and approve from any device with the short code it prints.

Yes. Run free-code login --manual to paste a Free.ai key or choose your own provider (OpenAI, Anthropic, Google or OpenRouter). Requests then go to that provider with your key.

Run free-code models to list every model Free.ai serves, with free tier models first. Add --free or --paid to filter. Switch inside a session with /model, or set a default with free-code config set model followed by the model id.

File edits and commands run on your machine. The model receives the parts of your project it needs to answer. Anonymous crash reports are off unless you turn them on, and they never include your code, prompts or file paths.

Run free-code update. It upgrades through whatever installed it: uv, pipx, pip or npm. Running the install line again also upgrades. Once a day free-code tells you when a newer release exists; it never installs by itself.

Use the tool that installed it: uv tool uninstall freeai-code, pipx uninstall freeai-code, pip uninstall freeai-code or npm uninstall -g freeai-code. If the installer used its own private environment, delete the .free-code folder in your home directory and the free-code file in .local/bin.

Yes. free-code -p followed by a task prints the answer and exits. Add --json for one JSON result and --yes to allow file edits. Dangerous commands stay blocked even with --yes, and the exit code tells you whether the task succeeded.

It uses the same Free.ai account. free-code rc lets you watch and drive a terminal session from the Free.ai app or from the sessions page, and free-code cloud runs a task in the Free.ai cloud and reports back.

Start coding with AI in your terminal

curl -fsSL https://free.ai/install.sh | sh

Windows and other install options · About Free.ai Coder

Amas a Free.ai?

Valora esta páxina