Metadata-Version: 2.4
Name: SuperGemini
Version: 3.1.3
Summary: SuperGemini Framework Management Hub
Project-URL: Homepage, https://github.com/SuperGemini-Org/SuperGemini_Framework
Project-URL: Repository, https://github.com/SuperGemini-Org/SuperGemini_Framework
Project-URL: Bug Tracker, https://github.com/SuperGemini-Org/SuperGemini_Framework/issues
Project-URL: GitHub, https://github.com/SuperGemini-Org/SuperGemini_Framework
Project-URL: Mithun Gowda B, https://github.com/mithun50
Project-URL: NomenAK, https://github.com/NomenAK
Author-email: Mithun Gowda B <contact@supergemini.dev>, NomenAK <contact@supergemini.dev>
License: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Requires-Dist: setuptools>=45.0.0
Description-Content-Type: text/markdown

# SuperGemini Framework

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://img.shields.io/pypi/v/SuperGemini.svg)](https://pypi.org/project/SuperGemini/)
[![Version](https://img.shields.io/badge/version-3.1.3-blue.svg)](https://github.com/SuperGemini-Org/SuperGemini_Framework)
[![GitHub issues](https://img.shields.io/github/issues/SuperGemini-Org/SuperGemini_Framework)](https://github.com/SuperGemini-Org/SuperGemini_Framework/issues)

A framework that extends Gemini CLI with specialized commands, personas, and MCP server integration.

## ✨ Features

### 🚀 17 Specialized Commands
**Development**: `/sg:implement`, `/sg:build`, `/sg:design`  
**Analysis**: `/sg:analyze`, `/sg:troubleshoot`, `/sg:explain`  
**Quality**: `/sg:improve`, `/sg:test`, `/sg:cleanup`  
**Planning**: `/sg:workflow`, `/sg:task`, `/sg:estimate`  
**Others**: `/sg:document`, `/sg:git`, `/sg:index`, `/sg:load`, `/sg:spawn`

### 🎭 Domain-Specific Personas
- **architect** - Systems design and architecture
- **frontend** - UI/UX development and accessibility  
- **backend** - Server-side development and infrastructure
- **analyzer** - Debugging and investigation
- **security** - Security analysis and vulnerabilities
- **scribe** - Documentation and technical writing

### 🔌 MCP Server Integration
- **Context7** - Official library documentation
- **Sequential** - Multi-step analysis (--seq flag)
- **Playwright** - Browser automation and testing

## 📦 Installation

### Prerequisites
- Python 3.8+
- Node.js 18+ (for MCP servers)
- Gemini CLI

### Quick Install
```bash
# Install from PyPI
pip install SuperGemini

# Verify installation
SuperGemini --version  # Should show: SuperGemini v3.1.3

# Install all components
SuperGemini install --quick --yes
```

### Custom Installation
```bash
# Interactive installation
SuperGemini install

# Install specific components
SuperGemini install --components commands mcp

# List available components
SuperGemini install --list-components
```

### Components
- **core** - Framework documentation and core files
- **commands** - 17 slash commands for Gemini CLI
- **mcp** - MCP server integration (auto-installs npm packages)
- **hooks** - Gemini CLI hooks (future-ready)

## 🎯 Usage

### Basic Commands
```gemini
/sg:analyze --seq      # Activate sequential-thinking for analysis
/sg:build             # Build with framework detection
/sg:improve --focus performance  # Performance optimization
```

### Flag Support
- `--seq` - Activate sequential-thinking MCP
- `--c7` - Activate Context7 documentation
- `--verbose` - Detailed output
- `--quiet` - Minimal output

## 🛠️ Configuration

Configuration files are stored in `~/.gemini/`:
- `settings.json` - Main configuration and MCP servers
- `commands/sg/*.toml` - Command definitions

## 🤝 Contributing

Contributions are welcome! Please check our [issues](https://github.com/SuperGemini-Org/SuperGemini_Framework/issues) page.

## 📄 License

MIT License - see [LICENSE](LICENSE) file for details.

## 👥 Authors

- **Mithun Gowda B** - [GitHub](https://github.com/mithun50)
- **NomenAK** - [GitHub](https://github.com/NomenAK)

## 🔗 Links

- [PyPI Package](https://pypi.org/project/SuperGemini/)
- [GitHub Repository](https://github.com/SuperGemini-Org/SuperGemini_Framework)
- [Issue Tracker](https://github.com/SuperGemini-Org/SuperGemini_Framework/issues)