Metadata-Version: 2.4
Name: SuperGemini
Version: 4.0.9
Summary: SuperGemini Framework Management Hub - AI-enhanced development framework for Gemini single-agent architecture
Home-page: https://github.com/SuperClaude-Org/SuperGemini_Framework
Author: hyunjae lim, NomenAK, Mithun Gowda B
Author-email: hyunjae lim <thecurrent.lim@gmail.com>, NomenAK <anton.knoery@gmail.com>, Mithun Gowda B <mithungowda.b7411@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/SuperClaude-Org/SuperGemini_Framework
Project-URL: GitHub, https://github.com/SuperClaude-Org/SuperGemini_Framework
Project-URL: Bug Tracker, https://github.com/SuperClaude-Org/SuperGemini_Framework/issues
Keywords: gemini,ai,automation,framework,mcp,agents,development,code-generation,assistant
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
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Environment :: Console
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: setuptools>=45.0.0
Requires-Dist: importlib-metadata>=1.0.0; python_version < "3.8"
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov>=2.0; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Requires-Dist: flake8>=4.0; extra == "dev"
Requires-Dist: mypy>=0.900; extra == "dev"
Provides-Extra: test
Requires-Dist: pytest>=6.0; extra == "test"
Requires-Dist: pytest-cov>=2.0; extra == "test"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# SuperGemini v4.0.8 🚀
[![Website Preview](https://img.shields.io/badge/Visit-Website-blue?logo=google-chrome)](https://superclaude-org.github.io/SuperGemini_Website/)
[![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-4.0.8-blue.svg)](https://github.com/SuperClaude-Org/SuperGemini_Framework)
[![GitHub issues](https://img.shields.io/github/issues/SuperClaude-Org/SuperGemini_Framework)](https://github.com/SuperClaude-Org/SuperGemini_Framework/issues)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/SuperClaude-Org/SuperGemini_Framework/blob/master/CONTRIBUTING.md)
[![Contributors](https://img.shields.io/github/contributors/SuperClaude-Org/SuperGemini_Framework)](https://github.com/SuperClaude-Org/SuperGemini_Framework/graphs/contributors)
[![Website](https://img.shields.io/website?url=https://superclaude-org.github.io/SuperGemini_Website/)](https://superclaude-org.github.io/SuperGemini_Website/)

SuperGemini is a meta-programming configuration framework that enhances Gemini CLI with structured development capabilities. It provides 18 slash commands in TOML format, 13 specialized AI agents with Persona Mode, behavioral instructions, and workflow automation for systematic software development.

## Quick Start

```bash
# Install SuperGemini Framework
pip install SuperGemini

# Setup SuperGemini for Gemini CLI (Choose one)
SuperGemini install --yes                    # Express setup (recommended)
SuperGemini install --profile minimal --yes  # Fastest (core only)
SuperGemini install --profile full --yes     # All features

# Use with Gemini CLI
# Example: /sg:analyze src/
# Example: /sg:implement user authentication
```

## What is SuperGemini? 💎

SuperGemini transforms Gemini CLI into a structured development platform by providing:

- **18 Slash Commands**: TOML-based commands for systematic workflow automation (/sg:analyze, /sg:implement, etc.)
- **Persona Mode**: 13 specialized AI agents that embody specific roles (system-architect, security-engineer, etc.)
- **Behavioral Instructions**: Core principles and rules for consistent development practices
- **Workflow Automation**: Systematic approaches to analysis, implementation, and optimization

Unlike traditional tools, SuperGemini uses **Persona Mode** where Gemini CLI embodies agent roles rather than spawning separate sub-agents.

[![GitHub Sponsors](https://img.shields.io/badge/sponsor-30363D?style=for-the-badge&logo=GitHub-Sponsors&logoColor=#white)](https://github.com/sponsors/SuperClaude-Org)

## Documentation

### Getting Started
- [Quick Start Guide](Docs/Getting-Started/quick-start.md)
- [Installation Guide](Docs/Getting-Started/installation.md)

### User Guides
- [Commands Reference](Docs/User-Guide/commands.md) - 18 TOML-based slash commands
- [Agents Guide](Docs/User-Guide/agents.md) - 13 specialized AI personas
- [Behavioral Modes](Docs/User-Guide/modes.md) - Context-aware operation modes
- [Flags Guide](Docs/User-Guide/flags.md) - Command flags and options
- [MCP Servers](Docs/User-Guide/mcp-servers.md) - MCP server integration guide
- [Session Management](Docs/User-Guide/session-management.md) - Session lifecycle management

### Developer Resources
- [Technical Architecture](Docs/Developer-Guide/technical-architecture.md)
- [Contributing Code](Docs/Developer-Guide/contributing-code.md)
- [Testing & Debugging](Docs/Developer-Guide/testing-debugging.md)

### Reference
- [Quick Start Practices](Docs/Reference/quick-start-practices.md)
- [Examples Cookbook](Docs/Reference/examples-cookbook.md)
- [Troubleshooting](Docs/Reference/troubleshooting.md)

## Contributing

**Current Priorities:**
- 📝 Documentation improvements and usage examples
- 🎯 TOML command workflow patterns and best practices
- 🤖 New AI agent personas for specialized domains
- 🧪 Testing and validation for Gemini CLI integration
- 🌐 Translation and internationalization

See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed contribution guidelines.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

**Contributors:** [View all contributors](https://github.com/SuperClaude-Org/SuperGemini_Framework/graphs/contributors)
