# huggingface/tau

A Python port of Pi’s minimalist coding agent.

Repository: https://github.com/huggingface/tau
Canonical: https://ross.abutalabs.com/products/huggingface-tau
Homepage: http://twotimespi.dev/
Language: Python
License: MIT
License Family: permissive
Last push: 2026-08-26T14:59:12+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 5
- inputs: {"age_days": 83, "days_push": 7, "days_rel": 9, "gap_med": 1, "n_releases_24m": 26}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2492, forks 303 (observed 2026-08-28T04:06:56.477776+00:00)

## What it is
Tau is a small, readable terminal coding agent written in Python, inspired by Pi, that can read files, edit code, run commands, and maintain durable sessions while streaming model output. It is also designed as a teaching project whose layered architecture (tau_ai, tau_agent, tau_coding) shows how coding agents are built.

## Use cases
- run an AI coding agent in the terminal
- learn how coding agents and agent loops are built
- have an agent explain a repo or fix a stack trace
- add tests or edit code with an LLM assistant
- run local GGUF models through llama.cpp in an agent
- study a provider-neutral agent harness implementation

## When to choose
- you want a lightweight, readable terminal coding agent you can inspect and extend
- you want to learn agent architecture from a small codebase instead of a giant production one
- you want to drive local models (GGUF via llama.cpp) alongside hosted providers

## When to avoid
- you need a battle-tested production coding agent with a large ecosystem
- you want a GUI or IDE-integrated assistant rather than a terminal TUI
- you need Python versions older than 3.12

## Facets
- artifact type: cli-tool
- maturity: active
- function: agent-framework, llm-inference, cli, terminal-ui, developer-tools, chat-interface
- domain: developer-tools, large-language-models, education
- platform: python, cli, cross-platform, windows
- tags: coding-agent, agent-loop, textual-tui, teaching-project, tool-calling, durable-sessions, local-llm, llama-cpp, ai-agents, command-line, macos, linux

## Member repositories
- huggingface/tau (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:56.477776+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:27:45.743781+00:00, confidence not recorded.
  - readme: https://github.com/huggingface/tau (fetched 2026-08-28T04:06:56.477776+00:00, sha 2dddb30b9f84)
  - homepage: http://twotimespi.dev/ (fetched 2026-08-29T10:09:54.131331+00:00, sha b9824097bcc6)
  - site_page: http://twotimespi.dev/quickstart (fetched 2026-08-29T10:09:54.133982+00:00, sha f779b2477bb4)
  - site_page: http://twotimespi.dev/releases (fetched 2026-08-29T10:09:54.135738+00:00, sha 41fc1f98ecba)
- Data as of 2026-08-30T08:39:29.467469+00:00.