# FreePi CLI

Canonical: https://freepi.ai/cli

A free AI coding agent in your terminal. Sign in with GitHub, no card.

Sign in with GitHub, no card. Tasteful terminal ads pay for the inference.

```sh
npx free-pi-cli@latest
```

Needs Node.js 22.15 or newer.

## How it works

Three steps.

1. **Run the CLI.** Execute `npx free-pi-cli@latest` in your terminal.
2. **Sign in with GitHub.** Approve the sign-in on a freepi.ai page that opens from your terminal. No payment details needed.
3. **Code for free.** Get a daily allowance of free coding help. Tasteful terminal ads cover the compute cost.

## Everything in the box.

- **Your choice of models.** Switch models anytime with `/model`. The list loads from the server, so it can change without a new release. [See all models](https://freepi.ai/models)
- **Free image generation.** Ask for a mockup, icon or illustration and it lands in your project's `images/` folder. No API key, no card. Each image counts toward your free daily allowance.
- **Cyber Defense.** An opt-in section of the `/model` picker for security work on systems you own or are authorized to test, plus a bundled security-audit skill. [Read about Defense](https://freepi.ai/cybersecurity)
- **Open source.** The CLI is open source under the MIT licence. Read the code on GitHub. [View on GitHub](https://github.com/dennisonbertram/free-pi-cli)
- **Based on Pi.** Built on the Pi agent harness by Mario Zechner. [Pi on GitHub](https://github.com/earendil-works/pi)
- **Invite a friend.** Run `/invite` in the CLI to get your link. [Check your referral status](https://freepi.ai/referrals)

Compare: [all comparisons](https://freepi.ai/vs)

## FAQ

### Is it really free?

Yes. You get a free daily allowance, and tasteful terminal ads cover the compute cost, so you never enter payment details.

### What do I need to run it?

A terminal, Node.js 22.15 or newer, and a GitHub account. No install is needed first: `npx` downloads and runs the CLI.

### Does it use my sessions for training?

We may train on session data to create a better experience and more powerful, lower-cost models. Do not put secrets or code you are not allowed to share into a session.

### What happens when I reach the daily limit?

Past the free allowance, requests run on a slower lane of spare capacity, and the server may ask you to try again in a little while. Credits spend after the free allowance, so bought or earned credits keep you going at full speed — `/buy-credits` opens the buy page. Slash commands such as `/usage` still work.

### Who is it for?

Built for developers who refuse to keep paying more for coding tools. If you're a student, indie developer, or building where standard tool pricing is prohibitive, this is for you.

## Other FreePi products

- [FreePi Desktop](https://freepi.ai/desktop) (Live): The same free agent as a Mac app. Pick a folder and start building.
- [FreePi Bots](https://freepi.ai/bots) (Live): Friendly agents in the cloud that get stuff done for you.
- [Free Web Search](https://freepi.ai/search) (Live): Free web search for your agents. No sign-in, no API key.
- [Sandboxes](https://freepi.ai/sandboxes) (Coming soon): Isolated cloud environments where your agents can run code.
- [Storage](https://freepi.ai/storage) (Coming soon): A place for your agents to keep files.
- [Tools](https://freepi.ai/tools) (Coming soon): Ready-made tools your agents can call.
