// agents · earendil-works/pi

pi

A TypeScript toolkit for building agents: unified LLM API, loop, TUI, and CLI.

★ 113.3k stars⑂ 14.4k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

pi is an open-source ai agents project by earendil-works (earendil-works/pi on GitHub). It has 113,328 GitHub stars and 14,403 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

GitHub stars
113,328
Forks
14,403
License
MIT
Last updated on GitHub
8 October 2026
Category
AI Agents
Listing
Full install guide
// how it works

How it works

  1. Pick a use case

    Choose one concrete task — narrow beats ambitious for a first run.

  2. Clone and explore

    Fetch the source and skim the docs folder.

  3. Configure credentials

    Set the environment variables or keys the project needs.

  4. Launch your first run

    Execute the example workflow and watch what happens.

// features

Why people love it

Unified LLM API

One interface across model providers.

Agent loop included

The core run loop, ready to build on.

Terminal UI

A TUI for interacting with your agents.

Coding agent CLI

A command-line coding agent out of the box.

TypeScript-native

Fits naturally into JS/TS stacks.

MIT licensed

Build commercial products on it freely.

Advertisement
// run it

Run it yourself

  1. Step 1 — Clone the repo

    Download the source and move into the project folder.

    git clone https://github.com/earendil-works/pi.git
    cd pi
  2. Step 2 — Install dependencies

    Pull in the Node packages the project needs.

    npm install
  3. Step 3 — Run it

    Start it with the project's documented command (often a dev server).

    npm run dev  # check README for the exact script
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains pi?

It is an open-source project at earendil-works/pi with 14403 forks. Check the contributors tab and recent commits to judge how active maintenance is.

Is pi free to use?

Yes — it's MIT licensed: free to use, modify, and ship commercially. Just keep the license notice in copies.

What does 'unified LLM API' mean?

One interface for many model providers, so you can swap models without rewriting agent code — check the README for the supported list.

Is this a framework or a toolkit?

A toolkit: the agent loop, TUI, and CLI are building blocks you assemble, not a platform you adopt.

How do I get started?

Clone the repo and follow the README quickstart — the README is the best starting point.

// keep exploring

Similar tools

AI Agents

botpress

Open-source hub of integrations, SDK and CLI for building and deploying GPT/LLM chatbots and agents.

★ 14.9k starsMIT
View guide →
AI Agents

adk-js

Google's code-first TypeScript toolkit for building AI agents.

★ 1.4k starsApache-2.0
View guide →
AI Agents

promptfoo

Test prompts, agents and RAGs — LLM evals, red teaming and model comparisons from the CLI

★ 25.8k starsMIT
View guide →
AI Agents

rivet

Rivet is Ironclad's visual IDE and TypeScript library for building complex AI agents and prompt chains

★ 4.7k starsMIT
View guide →
AI Agents

vocode-core

Build voice-based LLM agents with a modular, open-source toolkit.

★ 3.8k starsMIT
View guide →
AI Agents

Loop Engineering

Loop Engineering — practical patterns, starters and a CLI for designing the loops that prompt and orchestrate AI coding agents, with a Loop Ready score

★ 11.6k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if pi is not the right fit.

Get pi

Free and open — grab the source, star the repo, and start creating.