# BlitzCoder
⚡ **AI-Powered Development Assistant** - A comprehensive CLI tool for code generation, refactoring, and project management.
## Features
- 🤖 **AI-Powered Code Generation** - Generate code using Google's Gemini model
- 🔧 **Code Refactoring** - Automatically refactor and improve existing code
- 📁 **Project Scaffolding** - Create complete project structures with architecture plans
- 🧠 **Memory System** - Remember previous conversations and context
- 🛠️ **Development Tools** - File inspection, execution, and management tools
- 🔍 **Code Analysis** - Explain and analyze code functionality
## Installation
### Option 1: Install from Source (Recommended)
```bash
# Clone the repository
git clone https://github.com/Raghu6798/Blitz_Coder.git
cd BlitzCoder/blitz_cli
# Install in development mode
python install.py
```
### Option 2: Manual Installation
```bash
cd blitz_cli
pip install -e .
```
### Option 3: Direct Script Execution
```bash
# Windows
python scripts/blitzcoder.bat
# Linux/Mac
python scripts/blitzcoder
```
## Quick Start
### 1. Set up your API Keys
You'll need a Google API key for the Gemini model:
```bash
# Set environment variable
export GOOGLE_API_KEY="your-api-key-here"
# Or on Windows
set GOOGLE_API_KEY=your-api-key-here
```
### 2. Start Interactive Chat
```bash
blitzcoder chat
```
### 3. Search Memories
```bash
blitzcoder search-memories --query "your search term"
```
## Usage Examples
### Interactive Chat Mode
```bash
blitzcoder chat
```
This starts an interactive session where you can:
- Ask questions about code
- Request code generation
- Get help with refactoring
- Search through previous conversations
### Search Previous Conversations
```bash
blitzcoder search-memories --query "React component"
```
### Use with API Key Parameter
```bash
blitzcoder chat --google-api-key "your-api-key"
```
## Available Commands
| Command | Description |
|---------|-------------|
| `chat` | Start interactive AI chat session |
| `search-memories` | Search through conversation history |
## Development
### Project Structure
```
blitz_cli/
├── src/
│ └── blitzcoder/
│ ├── cli/
│ │ ├── __init__.py
│ │ └── cli_coder.py
│ └── __init__.py
├── config/
│ └── templates/
├── scripts/
│ ├── blitzcoder
│ └── blitzcoder.bat
├── setup.py
├── pyproject.toml
└── install.py
```
### Running Tests
```bash
# Install development dependencies
pip install -e ".[dev]"
# Run tests
pytest
```
### Code Formatting
```bash
# Format code
black src/
isort src/
# Type checking
mypy src/
```
## Configuration
The package uses environment variables for configuration:
- `GOOGLE_API_KEY` - Required for Gemini model access
- `GROQ_API_KEY` - Optional for additional models
- `NOVITA_API_KEY` - Optional for embeddings
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Support
- 📧 Email: raghunandanerukulla@gmail.com
- 🐛 Issues: [GitHub Issues](https://github.com/Raghu6798/BlitzCoder/issues)
- 📖 Documentation: [GitHub README](https://github.com/Raghu6798/BlitzCoder#readme)
## Acknowledgments
- Built with [LangGraph](https://github.com/langchain-ai/langgraph)
- Powered by [Google Gemini](https://ai.google.dev/)
- Enhanced with [Rich](https://github.com/Textualize/rich) for beautiful CLI output
Raw data
{
"_id": null,
"home_page": "https://github.com/Raghu6798/Blitz_Coder",
"name": "blitzcoder",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Raghu Nandan Erukulla <raghunandanerukulla@gmail.com>",
"keywords": "ai, code-generation, development, assistant, cli",
"author": "BlitzCoder Team",
"author_email": "BlitzCoder Team <raghunandanerukulla@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/43/3c/932abcd371b9bf73744495aedb828e59b88702b0d42ad271adcd72ce3758/blitzcoder-1.0.12.tar.gz",
"platform": null,
"description": "# BlitzCoder\r\n\r\n\u26a1 **AI-Powered Development Assistant** - A comprehensive CLI tool for code generation, refactoring, and project management.\r\n\r\n## Features\r\n\r\n- \ud83e\udd16 **AI-Powered Code Generation** - Generate code using Google's Gemini model\r\n- \ud83d\udd27 **Code Refactoring** - Automatically refactor and improve existing code\r\n- \ud83d\udcc1 **Project Scaffolding** - Create complete project structures with architecture plans\r\n- \ud83e\udde0 **Memory System** - Remember previous conversations and context\r\n- \ud83d\udee0\ufe0f **Development Tools** - File inspection, execution, and management tools\r\n- \ud83d\udd0d **Code Analysis** - Explain and analyze code functionality\r\n\r\n## Installation\r\n\r\n### Option 1: Install from Source (Recommended)\r\n\r\n```bash\r\n# Clone the repository\r\ngit clone https://github.com/Raghu6798/Blitz_Coder.git\r\ncd BlitzCoder/blitz_cli\r\n\r\n# Install in development mode\r\npython install.py\r\n```\r\n\r\n### Option 2: Manual Installation\r\n\r\n```bash\r\ncd blitz_cli\r\npip install -e .\r\n```\r\n\r\n### Option 3: Direct Script Execution\r\n\r\n```bash\r\n# Windows\r\npython scripts/blitzcoder.bat\r\n\r\n# Linux/Mac\r\npython scripts/blitzcoder\r\n```\r\n\r\n## Quick Start\r\n\r\n### 1. Set up your API Keys\r\n\r\nYou'll need a Google API key for the Gemini model:\r\n\r\n```bash\r\n# Set environment variable\r\nexport GOOGLE_API_KEY=\"your-api-key-here\"\r\n\r\n# Or on Windows\r\nset GOOGLE_API_KEY=your-api-key-here\r\n```\r\n\r\n### 2. Start Interactive Chat\r\n\r\n```bash\r\nblitzcoder chat\r\n```\r\n\r\n### 3. Search Memories\r\n\r\n```bash\r\nblitzcoder search-memories --query \"your search term\"\r\n```\r\n\r\n## Usage Examples\r\n\r\n### Interactive Chat Mode\r\n\r\n```bash\r\nblitzcoder chat\r\n```\r\n\r\nThis starts an interactive session where you can:\r\n- Ask questions about code\r\n- Request code generation\r\n- Get help with refactoring\r\n- Search through previous conversations\r\n\r\n### Search Previous Conversations\r\n\r\n```bash\r\nblitzcoder search-memories --query \"React component\"\r\n```\r\n\r\n### Use with API Key Parameter\r\n\r\n```bash\r\nblitzcoder chat --google-api-key \"your-api-key\"\r\n```\r\n\r\n## Available Commands\r\n\r\n| Command | Description |\r\n|---------|-------------|\r\n| `chat` | Start interactive AI chat session |\r\n| `search-memories` | Search through conversation history |\r\n\r\n## Development\r\n\r\n### Project Structure\r\n\r\n```\r\nblitz_cli/\r\n\u251c\u2500\u2500 src/\r\n\u2502 \u2514\u2500\u2500 blitzcoder/\r\n\u2502 \u251c\u2500\u2500 cli/\r\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\r\n\u2502 \u2502 \u2514\u2500\u2500 cli_coder.py\r\n\u2502 \u2514\u2500\u2500 __init__.py\r\n\u251c\u2500\u2500 config/\r\n\u2502 \u2514\u2500\u2500 templates/\r\n\u251c\u2500\u2500 scripts/\r\n\u2502 \u251c\u2500\u2500 blitzcoder\r\n\u2502 \u2514\u2500\u2500 blitzcoder.bat\r\n\u251c\u2500\u2500 setup.py\r\n\u251c\u2500\u2500 pyproject.toml\r\n\u2514\u2500\u2500 install.py\r\n```\r\n\r\n### Running Tests\r\n\r\n```bash\r\n# Install development dependencies\r\npip install -e \".[dev]\"\r\n\r\n# Run tests\r\npytest\r\n```\r\n\r\n### Code Formatting\r\n\r\n```bash\r\n# Format code\r\nblack src/\r\nisort src/\r\n\r\n# Type checking\r\nmypy src/\r\n```\r\n\r\n## Configuration\r\n\r\nThe package uses environment variables for configuration:\r\n\r\n- `GOOGLE_API_KEY` - Required for Gemini model access\r\n- `GROQ_API_KEY` - Optional for additional models\r\n- `NOVITA_API_KEY` - Optional for embeddings\r\n\r\n## Contributing\r\n\r\n1. Fork the repository\r\n2. Create a feature branch\r\n3. Make your changes\r\n4. Add tests if applicable\r\n5. Submit a pull request\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the LICENSE file for details.\r\n\r\n## Support\r\n\r\n- \ud83d\udce7 Email: raghunandanerukulla@gmail.com\r\n- \ud83d\udc1b Issues: [GitHub Issues](https://github.com/Raghu6798/BlitzCoder/issues)\r\n- \ud83d\udcd6 Documentation: [GitHub README](https://github.com/Raghu6798/BlitzCoder#readme)\r\n\r\n## Acknowledgments\r\n\r\n- Built with [LangGraph](https://github.com/langchain-ai/langgraph)\r\n- Powered by [Google Gemini](https://ai.google.dev/)\r\n- Enhanced with [Rich](https://github.com/Textualize/rich) for beautiful CLI output \r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "AI-powered development assistant for code generation, refactoring, and project management",
"version": "1.0.12",
"project_urls": {
"Bug Tracker": "https://github.com/Raghu6798/BlitzCoder/issues",
"Documentation": "https://github.com/Raghu6798/BlitzCoder#readme",
"Homepage": "https://github.com/Raghu6798/BlitzCoder",
"Repository": "https://github.com/Raghu6798/BlitzCoder"
},
"split_keywords": [
"ai",
" code-generation",
" development",
" assistant",
" cli"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e1339f4a2b0295476cd1a93d627b45dc9b9f6e6e244ac1cdd4207638c753bb9d",
"md5": "d5b569457b94dcedb641afd086fc5a73",
"sha256": "c4d2d038058ed76c80e37e6659c3a0ac49bba417784cfdcffd8712ab2ce1a46b"
},
"downloads": -1,
"filename": "blitzcoder-1.0.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d5b569457b94dcedb641afd086fc5a73",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 39433,
"upload_time": "2025-08-07T14:46:26",
"upload_time_iso_8601": "2025-08-07T14:46:26.597579Z",
"url": "https://files.pythonhosted.org/packages/e1/33/9f4a2b0295476cd1a93d627b45dc9b9f6e6e244ac1cdd4207638c753bb9d/blitzcoder-1.0.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "433c932abcd371b9bf73744495aedb828e59b88702b0d42ad271adcd72ce3758",
"md5": "079afbf2bf2279d399256830760a23a5",
"sha256": "bc46f24498648b673a351a8983b168f439f679480f233f978ccc90fe28eef4d4"
},
"downloads": -1,
"filename": "blitzcoder-1.0.12.tar.gz",
"has_sig": false,
"md5_digest": "079afbf2bf2279d399256830760a23a5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 43065,
"upload_time": "2025-08-07T14:46:27",
"upload_time_iso_8601": "2025-08-07T14:46:27.955846Z",
"url": "https://files.pythonhosted.org/packages/43/3c/932abcd371b9bf73744495aedb828e59b88702b0d42ad271adcd72ce3758/blitzcoder-1.0.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-07 14:46:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Raghu6798",
"github_project": "Blitz_Coder",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "blitzcoder"
}
JSON
