ai-agent

Simplify AI with pi

Name: Simplify AI with pi
Author: earendil-works

Get a unified AI agent toolkit for startup founders, including LLM API and CLI tools, with 67k+ GitHub stars

81,176 stars10,018 forksTypeScriptHealth Score 9/10Updated 7/31/2026100% free · open source

What it does

Pi provides a unified AI agent toolkit for startup founders, allowing them to leverage a large language model (LLM) API, agent loop, and command-line interface (CLI) tools to automate tasks and workflows.

Install / run

git clone https://github.com/earendil-works/pi.git && cd pi

When to use it

•When you need to integrate AI-driven automation into your startup's workflow
•When you want to use a unified toolkit for building, testing, and deploying AI-powered agents
•When you require a flexible and customizable AI solution with a strong community backing (67k+ GitHub stars)

Quick start

1Run `npm install` to set up the project dependencies
2Use `npm run build` to compile the TypeScript code
3Execute `npm run start` to launch the pi agent
4Interact with the agent using the `pi` command in your terminal, following the prompts and guidance from the tool's output
5Explore the `examples` directory for pre-built workflows and configurations to adapt to your needs

Ready-to-paste prompt

pi eval 'your_large_language_model_prompts_here' -- to interact with the LLM API and receive a response

Heads up: Make sure you have Node.js (16 or higher) and npm installed on your system before attempting to install and run pi, as it relies on these to function correctly

Saves to your device

How Simplify AI with pi works

Codeflow

Free to inspect

Simplify AI with pi is a very large TypeScript project (~130k lines across 692 code files, plus 486 test files). It is a full software project: use it through its install path rather than reading it end to end. Last commit this month, MIT license, has a test suite.

Size

Very large codebase

~130k lines · 692 code files · days to read — use, don't read

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

Node.js

No API keys detected

TypeScript 94%JavaScript 5%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
AGENTS.md
The instructions the AI actually follows
3
package.json
Dependencies and the commands it exposes
4
packages/agent/README.md
Inside packages/agent/ — an example of what the AI is told to do

What's in each folder

packages/agent/Prompts, skills & agent definitions86 files

packages/server/Backend / API31 files

packages/client/Frontend / UI23 files

packages/coding-agent/Package640 files

packages/ai/Package327 files

packages/tui/Package92 files

packages/session-backends/Package37 files

scripts/Helper scripts33 files

READMEHas testsDocumentedCI checksMIT licenseUpdated this month

Quick Actions

Details