ContextQMD
Back to Pi Mono

Pi Monorepo

README.md

0.73.03.5 KB
Original Source
<p align="center"> <a href="https://pi.dev"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://pi.dev/logo.svg"> <source media="(prefers-color-scheme: light)" srcset="https://huggingface.co/buckets/julien-c/my-training-bucket/resolve/pi-logo-dark.svg"> 
</picture>
</a> </p> <p align="center"> <a href="https://discord.com/invite/3cU7Bz4UPx"></a> <a href="https://github.com/badlogic/pi-mono/actions/workflows/ci.yml"></a> </p> <p align="center"> <a href="https://pi.dev">pi.dev</a> domain graciously donated by <a href="https://exe.dev"> exe.dev</a> </p>

New issues and PRs from new contributors are auto-closed by default. Maintainers review auto-closed issues daily. See CONTRIBUTING.md.

Pi Monorepo

Looking for the pi coding agent? See packages/coding-agent for installation and usage.

Tools for building AI agents.

Share your OSS coding agent sessions

If you use pi or other coding agents for open source work, please share your sessions.

Public OSS session data helps improve coding agents with real-world tasks, tool use, failures, and fixes instead of toy benchmarks.

For the full explanation, see this post on X.

To publish sessions, use badlogic/pi-share-hf. Read its README.md for setup instructions. All you need is a Hugging Face account, the Hugging Face CLI, and pi-share-hf.

You can also watch this video, where I show how I publish my pi-mono sessions.

I regularly publish my own pi-mono work sessions here:

Packages

PackageDescription
@mariozechner/pi-aiUnified multi-provider LLM API (OpenAI, Anthropic, Google, etc.)
@mariozechner/pi-agent-coreAgent runtime with tool calling and state management
@mariozechner/pi-coding-agentInteractive coding agent CLI
@mariozechner/pi-tuiTerminal UI library with differential rendering
@mariozechner/pi-web-uiWeb components for AI chat interfaces

Chat bot workflows

For Slack/chat automation, see earendil-works/pi-chat.

Contributing

See CONTRIBUTING.md for contribution guidelines and AGENTS.md for project-specific rules (for both humans and agents).

Development

bash
npm install          # Install all dependencies
npm run build        # Build all packages
npm run check        # Lint, format, and type check
./test.sh            # Run tests (skips LLM-dependent tests without API keys)
./pi-test.sh         # Run pi from sources (can be run from any directory)

Note: npm run check requires npm run build to be run first. The web-ui package uses tsc which needs compiled .d.ts files from dependencies.

License

MIT