Skip to main content

minipi

A lightweight coding agent, heavily inspired by pi. It is written in Python for better readability.

▄███████▄
█ • ◡ • █
  █   █  
  █   █▄ 

Features

  • Streaming responses
  • 4 tools: read, write, edit, bash with a minimal sandbox
  • Project context loading (loads AGENTS.md and .agents/skills)
  • Support for commands (slash commands, e.g. /rewind, /resume, /permission)
  • Session persistence to ~/.mini-pi
  • Support for hooks, which are triggered at specific points in the agent lifecycle (e.g. input hook, pre tool call, post tool call)
  • Support for extensions (to expand the capabilities of the agent). This includes adding new tools, adding new AI vendors, and adding commands.
  • Auto compaction (or /compact <custom instructions>) to compact the older messages
  • Basic TUI
  • Support for steering and follow-ups

A few things:

  • Built-in support only for the OpenAI Chat Completions API. Tested only on fireworks.ai (with a few models), though more vendors can be added via extensions.
  • I tested it only on Ubuntu, though it should work on other OSes.
  • The sandbox supports only Linux.

Setup

  • System requirements: Python, uv and Node.js (for the TUI).
  • Run uv tool install mini-pi-agent. See PyPI here.
  • cd to the workspace you want to work in and run minipi.
  • Run /login fireworks fw_UIO.... The API key persists in raw form in ~/.mini-pi/auth.json.
  • Run /help to learn about more commands.

Metadata

Release files for mini-pi-agent 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mini-pi-agent 0.1.3
File Size Uploaded Provenance Actions
mini_pi_agent-0.1.3.tar.gz 159.0 kB With provenance Details for mini_pi_agent-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mini-pi-agent 0.1.3
File Interpreter ABI Platform Actions
mini_pi_agent-0.1.3-py3-none-any.whl Python 3 none any Details for mini_pi_agent-0.1.3-py3-none-any.whl

Total release size: 339.4 kB

Release files / mini_pi_agent-0.1.3.tar.gz

Download URL mini_pi_agent-0.1.3.tar.gz
Size 159.0 kB
Tags Source
SHA-256 checksum
How to use checksums
644a16510a6a2381e2f0dfb6a4b953e4a449019b4ed57c5f355f240be49a82dd
BLAKE2b-256 checksum
How to use checksums
0426afca4c986163188b9bfc5e8a4b96cf0afa4b78764f3a94d7a7476cb6fa6d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.

Transparency log

Release files / mini_pi_agent-0.1.3-py3-none-any.whl

Download URL mini_pi_agent-0.1.3-py3-none-any.whl
Size 180.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b51a1d205d299d60a4ca32821ef1987b6cfdc3a074ae6d1f9333c3c5de3cb2a4
BLAKE2b-256 checksum
How to use checksums
72bfa01e56ea04b7ac31e294ac7e776ef3082a644edaf9b6541a02fb5644302e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.

Transparency log

Security for mini-pi-agent 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for mini_pi_agent-0.1.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page