Skip to main content

Mini pi

A minimal coding agent in python.

For the past month I have been exploring how to create an agent from scratch without frameworks, and I have also been digging into how to do evaluations. You can see the experiment artifacts here: https://gitlab.com/nik-55/llm-systems

Based on what I learned there, I want to build a harness that works and stays small. The goal is to keep it readable. Currently it follows the tau architecture

The current state:

  • No AI slop, and around 1700 lines of code
  • Streaming responses
  • 4 tools (read, write, bash, edit)
  • Sandboxing using bwrap on Linux
  • Interruption handling
  • Session persistence
  • A few basic commands (/clear, /session, /resume, /exit)
  • REPL only for now

Setup

  • requirements: nodejs, python and uv
  • see python package here
  • install the tool using uv tool install mini-pi-agent
  • export the environment variables:
export OPENAI_API_KEY=
export OPENAI_BASE_URL=
export MODEL=
  • run minipi from any of your project

Metadata

Release files for mini-pi-agent 0.1.2

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.2
File Size Uploaded Provenance Actions
mini_pi_agent-0.1.2.tar.gz 157.1 kB With provenance Details for mini_pi_agent-0.1.2.tar.gz

Built distribution (wheel)

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

Total release size: 333.8 kB

Release files / mini_pi_agent-0.1.2.tar.gz

Download URL mini_pi_agent-0.1.2.tar.gz
Size 157.1 kB
Tags Source
SHA-256 checksum
How to use checksums
72be81985c145a92ac91f43309c3a6748d1f97bb4d21ee55ee95e186feb07f82
BLAKE2b-256 checksum
How to use checksums
9d289e90fd03ac22fccbf6b2a1c0c3b3ec01b49f500ca63b9f1c3d617063f430
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 22, 2026.

Transparency log

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

Download URL mini_pi_agent-0.1.2-py3-none-any.whl
Size 176.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5dab8929ab2cf933264039e741f3f1095c0cee6fb4dec47c23359ae2cc64f017
BLAKE2b-256 checksum
How to use checksums
9b3373882a48a8c8eae22f31c911d0571a729a80a8ec04ad65c697d85406dec1
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 22, 2026.

Transparency log

Security for mini-pi-agent 0.1.2

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.2.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 22, 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