Skip to main content

Boring for Gemini

PyPI version License

Autonomous AI Agent Loop with VibeCoder Experience


✨ The Vibe Coder Experience

No Code Needed. Just describe the vibe.

Boring-Gemini features a Universal Natural Language Router. You don't need to remember 60+ complex tools. Just say what you want:

"Search for authentication logic"
"Review my code for security issues"
"幫我寫測試" (Help me write tests)


🚀 Quick Start (One-Click)

🪄 Zero-Config Wizard

Boring features a smart setup wizard that automatically bridges your IDE (Cursor, VS Code, Claude Desktop) with the Gemini agent.

pip install "boring-aicoding[all]"
boring wizard

💎 Smithery Integration

One-click install for Cursor/Claude Desktop.

npx -y @smithery/cli@latest install boring/boring --client cursor

🔮 The Anti-Rage Revolution (V15.0.0)

V15.0.0 focuses on UX Hardening and Resilience, transforming Boring into a robust partner that doesn't just work, but communicates its progress:

  • 🧠 Cognitive Architecture (System 2): Uses sequentialthinking to plan, reason, and revise before execution.
  • 🐉 One Dragon Flow: Autonomous traversal of the entire SDLC (Design → Build → Polish → Verify).
  • 🔮 Predictive Intelligence: boring predict and boring bisect catch errors before they happen.
  • 🔌 Offline-First Mode: 100% network-independent operation with local LLMs via llama-cpp-python.
  • 🛡️ Sovereign Autonomy: Managed tool governance (boring policy) and knowledge continuity (boring bio).
  • 🩺 Self-Healing: boring doctor --fix automatically repairs your environment.

⚡ Core Capabilities

Feature Description
🧠 Autonomous Loop Thinking → Coding → Testing → Fixing with System 2 reasoning.
🕵️ Context Optimization 80% token savings via smart chunking and semantic specificity ranking.
🛡️ Shadow Mode Safe execution sandbox catches destructive operations before they happen.
🧩 Natural Language Universal Router: "幫我寫測試" or "Fix auth bugs" triggered instantly.
🧪 Vibe Score Gamified health check: Lint, Security, and Docs tracked over time.

📦 Usage Modes

{
  "mcpServers": {
    "boring": { "command": "boring-mcp" }
  }
}

Managed CLI Utilities

  • boring flow: Start the One Dragon autonomous flow.
  • boring wizard: Bridge Cursor, Claude, VSCode, and more in seconds.
  • boring-monitor: Fullscreen TUI dashboard for live agent monitoring.
  • boring-dashboard: Modern web UI for project health and history.

About boring-route: This command only shows which MCP tool would be selected for your query. To actually execute the tool, use it in your MCP client (Cursor/Claude Desktop).


🔧 Key Features

  • 67+ MCP Tools: RAG, Testing, Review, Security, Git, and more
  • Predictive Error Detection: pro-active anti-pattern analysis
  • Local LLM Support: Llama 3, Qwen 2.5, Phi-3 integration
  • Multi-Language: Python, JavaScript, TypeScript, Go, C++ support
  • Quality Gates: CI/CD integration with multi-tier verification
  • Memory System: Persistent learning and pattern recognition

📚 Documentation


📄 License

Apache 2.0 - See LICENSE

Metadata

Release files for boring-aicoding 15.0.0

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

Source distribution (sdist)

Source distribution for boring-aicoding 15.0.0
File Size Uploaded
boring_aicoding-15.0.0.tar.gz 698.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for boring-aicoding 15.0.0
File Interpreter ABI Platform
boring_aicoding-15.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 1.5 MB

Release files / boring_aicoding-15.0.0.tar.gz

Download URL boring_aicoding-15.0.0.tar.gz
Size 698.4 kB
Tags Source
SHA-256 checksum
How to use checksums
4e48479dcf24fcba19ba7aefa71ef0a844cc77a26412aa01b09a53c416c8530a
BLAKE2b-256 checksum
How to use checksums
0546270d1650c1059af856a63d486a214e0c31c8542fadafc9aaa9a4c76751ec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.14

Release files / boring_aicoding-15.0.0-py3-none-any.whl

Download URL boring_aicoding-15.0.0-py3-none-any.whl
Size 821.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6c9883709d85b5215b3b4352c0c3f0c2a62117cad4e8a05503c10114041de1d8
BLAKE2b-256 checksum
How to use checksums
b4b6a20b6739733e7775d78bed56f7d5b3c619b0aa72b35d4d5a0e23fb976a11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.14

Release history Release notifications | RSS feed

This release

15.0.0 This release

2 release files

14.0.0

2 release files

12.0.0

2 release files

11.5.0

2 release files

11.2.9

2 release files

11.2.8

2 release files

11.2.7

2 release files

11.2.6

2 release files

11.2.5

2 release files

11.2.4

2 release files

11.2.3

2 release files

11.2.2

2 release files

11.2.1

2 release files

11.1.0

2 release files

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