Metadata-Version: 2.4
Name: boring-aicoding
Version: 10.32.1
Summary: Boring Vibecoder Assistant: An AI-powered development support tool handling project planning, logic verification, and knowledge management. Works alongside Cursor, Copilot, and others to ensure rigorous, efficient workflows.
Author-email: Boring206 <C112156246@nkust.edu.tw>
Project-URL: Homepage, https://github.com/Boring206/boring-gemini
Project-URL: Repository, https://github.com/Boring206/boring-gemini
Project-URL: Documentation, https://github.com/Boring206/boring-gemini#readme
Project-URL: Bug Tracker, https://github.com/Boring206/boring-gemini/issues
Keywords: gemini,ai,autonomous-agent,devops
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Framework :: Pytest
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: python-dotenv
Requires-Dist: google-genai>=1.0.0
Requires-Dist: python-dateutil
Requires-Dist: gitpython
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: structlog>=24.0.0
Requires-Dist: tenacity>=8.0.0
Requires-Dist: duckduckgo-search>=5.0.0
Requires-Dist: requests
Requires-Dist: tomli>=2.0.0; python_version < "3.11"
Provides-Extra: gui
Requires-Dist: streamlit>=1.30.0; extra == "gui"
Requires-Dist: pyarrow; extra == "gui"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-mock>=3.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: types-python-dateutil; extra == "dev"
Requires-Dist: types-requests; extra == "dev"
Requires-Dist: radon>=6.0.0; extra == "dev"
Requires-Dist: interrogate>=1.5.0; extra == "dev"
Requires-Dist: bandit>=1.7.0; extra == "dev"
Requires-Dist: pip-audit>=2.7.0; extra == "dev"
Requires-Dist: mkdocs>=1.5.0; extra == "dev"
Requires-Dist: mkdocs-material>=9.5.0; extra == "dev"
Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "dev"
Requires-Dist: psutil>=5.9.0; extra == "dev"
Provides-Extra: vector
Requires-Dist: chromadb>=0.4.0; extra == "vector"
Requires-Dist: sentence-transformers>=2.2.0; extra == "vector"
Requires-Dist: tree-sitter-languages>=1.10.0; extra == "vector"
Provides-Extra: mcp-lite
Requires-Dist: fastmcp>=2.0.0; extra == "mcp-lite"
Requires-Dist: mcp>=1.15.0; extra == "mcp-lite"
Requires-Dist: smithery>=0.4.2; extra == "mcp-lite"
Requires-Dist: uvicorn>=0.30.0; extra == "mcp-lite"
Requires-Dist: starlette>=0.37.0; extra == "mcp-lite"
Requires-Dist: bandit>=1.7.0; extra == "mcp-lite"
Requires-Dist: pip-audit>=2.7.0; extra == "mcp-lite"
Provides-Extra: mcp
Requires-Dist: boring-aicoding[mcp-lite]; extra == "mcp"
Requires-Dist: chromadb>=0.4.0; extra == "mcp"
Requires-Dist: sentence-transformers>=2.2.0; extra == "mcp"
Requires-Dist: win10toast>=0.9; platform_system == "Windows" and extra == "mcp"
Provides-Extra: all
Requires-Dist: boring-aicoding[dev,gui,mcp,vector]; extra == "all"
Dynamic: license-file

# Boring for Gemini

[![PyPI version](https://badge.fury.io/py/boring-aicoding.svg)](https://badge.fury.io/py/boring-aicoding)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

**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 98+ complex tools. Just say what you want:

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

---

## ⚡ Why Boring?

| Feature | Description |
|---------|-------------|
| 🧠 **Autonomous Loop** | Runs continuously, thinking, coding, testing, and fixing until done |
| 🕵️ **Hybrid RAG** | Advanced code search with HyDE + Cross-Encoder |
| 🛡️ **Shadow Mode** | Safe execution sandbox catches dangerous ops before they happen |
| ⚡ **30% Faster** | Smart caching reduces context usage by 80% |
| 🧩 **Vibe Coder** | Most human-friendly AI coding interface |

---

## 🚀 Quick Installation

### Smithery (Recommended)

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

### Local pip

```bash
pip install boring-aicoding[mcp]
```

---

## 📦 Usage

### As MCP Server (Recommended)

Add to your IDE's MCP configuration:

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

### CLI Tools (Run in Terminal/CMD)

> **Note**: These are standalone CLI commands. Run them in your terminal, not in MCP client.

```bash
boring-monitor           # TUI Dashboard (Terminal UI)
boring-dashboard         # Web Dashboard (Opens browser)
boring-route "query"     # Shows which tool would be used (demo only, doesn't execute)
python -m boring status  # Health check
python -m boring verify  # Code verification
```

**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

- **55+ MCP Tools**: RAG, Testing, Review, Security, Git, and more
- **Multi-Language**: Python, JavaScript, TypeScript support
- **Quality Gates**: CI/CD integration with multi-tier verification
- **Memory System**: Persistent learning and pattern recognition
- **LLM-as-a-Judge**: Advanced evaluation with bias monitoring

---

## 📚 Documentation

- [GitHub Repository](https://github.com/Boring206/boring-gemini)
- [Vibe Coder Guide](https://github.com/Boring206/boring-gemini/blob/main/docs/guides/vibe-coder.md)
- [MCP Tools Reference](https://github.com/Boring206/boring-gemini/blob/main/docs/features/mcp-tools.md)

---

## 📄 License

Apache 2.0 - See [LICENSE](https://github.com/Boring206/boring-gemini/blob/main/LICENSE)
