This release is a pre-release and may not be stable for production use.
🤙 yeaboi.ai
Best friend to engineers and agents — plans, standups, retros, performance & reporting for your team, plus cost, digests and security posture for the AI agents working alongside it. All from your terminal.
Two worlds, one command: scrum for your team, and cost, digests & security posture for your agents.
🚀 Quick Start
Recommended: uv or pipx
The most reliable way to install — pulls the full dependency tree from PyPI and isolates it in its own environment:
uv tool install yeaboi # or: pipx install yeaboi
yeaboi --setup # configure your API key
yeaboi # launch the interactive TUI
Note on names: the package was previously published as
scrum-agent. It is nowyeaboion PyPI, matching the command. A finalscrum-agentrelease remains as a thin redirect that installsyeaboi, and the legacyscrum-agentcommand still works as an alias for that release — but new installs should useyeaboi.
Voice input needs no separate install. Double-tap Space in any text field and yeaboi
offers to set dictation up in place — it installs the packages into the environment it is
already running in, downloads the speech model with a progress bar, and drops straight
into recording. No restart, no second terminal. (yeaboi --install-voice does the same
thing headlessly, for CI and dev containers.)
It is kept out of the base install rather than bundled because the speech engine
(ctranslate2, onnxruntime) publishes wheels only for 64-bit macOS, glibc ≥ 2.28 Linux
and Windows — making it a hard dependency would break pip install yeaboi outright on
Alpine/musl, older glibc, 32-bit and armv7 hosts. On those platforms yeaboi says so
instead of offering an install that cannot work.
Optional extras can still be requested at install time if you prefer:
uv tool install "yeaboi[voice]" # 🎤 dictation, pre-installed rather than on demand
uv tool install "yeaboi[all-providers]" # OpenAI, Google, and Bedrock providers
uv tool install "yeaboi[core]" # ⚡ prebuilt Go engine for the Agents pages
pipx install "yeaboi[voice]" # equivalent with pipx
The
coreextra installsyeaboi-core, a small prebuilt Go binary that serves the Agents pages' local scans (usage, standup, security) and the Daily Standup's deterministic aggregation (grouping, practice signals, confidence). yeaboi detects it automatically — nothing to configure — and every result is verified byte-identical to the built-in Python implementation, which remains the complete fallback (setYEABOI_GO=0to force it). Wheels ship for 64-bit macOS, Linux (glibc and musl — the binary is static) and Windows.
Voice input transcribes on-device with faster-whisper — no API key, works with every LLM provider (Anthropic, Bedrock, …). On macOS/Windows it is fully self-contained (the
sounddevicewheel bundles PortAudio). On Linux, also install the system library:sudo apt install libportaudio2— yeaboi will not runsudofor you. A small Whisper model downloads on first use (~140 MB for the defaultbase; setVOICE_MODELtotiny/small/medium/large-v3to trade size for accuracy).
Homebrew is not supported. A required dependency (
sqlite-vec) ships no source distribution, which Homebrew's source-build model can't handle, sobrew install yeaboiis intentionally disabled. Useuv tool installorpipx installabove instead.
From source
git clone https://github.com/dinho149/yeaboi.ai.git
cd yeaboi.ai
make install # installs uv, creates venv, installs dependencies
make env # creates .env from .env.example — add your API key
make run # launch the CLI
Headless / CI mode
yeaboi --non-interactive --description "Build a todo app" --output json
yeaboi --non-interactive --description @project-brief.txt --output html --team-size 5
✨ Features
🖥️ Full-screen TUI — Animated splash, mode selection, pipeline progress, dark/light themes 🧠 Smart Intake — Extracts answers from your project description, asks only what's missing — or feed it a whole quarterly roadmap with Roadmap Intake 🔄 Seven modes, one command — Planning, Daily Standup, Retro, Planning Poker, Performance (beta), Reporting, Team Analysis 🤖 Agents too, not just humans (beta) — a robotic-duck landing split opens the Agents family: what your AI coding agents cost, how much of that spend is recoverable, a daily digest of what they did, and a security audit of your agent setup — computed locally from Claude Code session logs, transcripts never leave your machine 🔌 37 tools — GitHub, Azure DevOps, Jira, Confluence, Notion, local codebase scanning, and more 📤 5 export formats — Markdown, HTML, JSON, Jira sync, Azure DevOps Boards sync 🤖 5 LLM providers — Claude (default), GPT, Gemini, AWS Bedrock, or fully local & keyless with Ollama 🧩 Every surface — TUI, CLI subcommands, MCP server, and a Claude Code plugin, with feature parity enforced in CI 💾 Session persistence — SQLite-backed sessions plus a saved-runs hub for past standups, retros, and reports 🛡️ Guardrails — Input/output validation, human-in-the-loop review at every stage
📖 Full Documentation
Getting started, the full CLI reference, every mode in depth, integrations, architecture, and deployment guides: yeaboi.ai/docs
📄 License
MIT License. See LICENSE for details.
1 maintainer
Metadata
1 maintainer
Release files for yeaboi 3.22.0rc133
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| yeaboi-3.22.0rc133.tar.gz | 7.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| yeaboi-3.22.0rc133-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 10.3 MB
Release files / yeaboi-3.22.0rc133.tar.gz
| Download URL | yeaboi-3.22.0rc133.tar.gz |
|---|---|
| Size | 7.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cb6715d41d36c3708b8cea8203eb167d4ddef7595f993956e0e301c54232eb8c
|
|
BLAKE2b-256 checksum How to use checksums |
4777bc879da16f7c82f852a36127d9fb3ab6323f212c321698e20d2d2f284799
|
| 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 Aug 19, 2026.
Transparency logRelease files / yeaboi-3.22.0rc133-py3-none-any.whl
| Download URL | yeaboi-3.22.0rc133-py3-none-any.whl |
|---|---|
| Size | 3.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f31b2c044cc1cb15ec9dbb3660e94001fb82f2de8c152ecda2a481639c52d10c
|
|
BLAKE2b-256 checksum How to use checksums |
0f4da79760169a3a9759b07e090434fd6455f0f3264cb714707bea8e8c43b765
|
| 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 Aug 19, 2026.
Transparency log
