{"id":28438541,"url":"https://github.com/Dumb-Kid-Root/Vibe-Coder","last_synced_at":"2025-06-28T17:31:45.134Z","repository":{"id":284095978,"uuid":"953809058","full_name":"Dumb-Kid-Root/Vibe-Coder","owner":"Dumb-Kid-Root","description":"👨‍💻A powerful and flexible AI code generation tool that helps developers create, modify, and improve code using advanced language models \u0026 Espada Agents.","archived":false,"fork":false,"pushed_at":"2025-05-15T15:48:15.000Z","size":15552,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-28T16:02:38.406Z","etag":null,"topics":["ai","chatgpt","coding","espada","gemini","gen-ai","generative-ai","llm","python3","vibe-coding"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dumb-Kid-Root.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-24T05:37:10.000Z","updated_at":"2025-06-24T23:08:53.000Z","dependencies_parsed_at":"2025-06-28T16:12:52.305Z","dependency_job_id":null,"html_url":"https://github.com/Dumb-Kid-Root/Vibe-Coder","commit_stats":null,"previous_names":["vinsmokesomya/vibe-coder","dumb-kid-root/vibe-coder"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Dumb-Kid-Root/Vibe-Coder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dumb-Kid-Root%2FVibe-Coder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dumb-Kid-Root%2FVibe-Coder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dumb-Kid-Root%2FVibe-Coder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dumb-Kid-Root%2FVibe-Coder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dumb-Kid-Root","download_url":"https://codeload.github.com/Dumb-Kid-Root/Vibe-Coder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dumb-Kid-Root%2FVibe-Coder/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262468725,"owners_count":23316175,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chatgpt","coding","espada","gemini","gen-ai","generative-ai","llm","python3","vibe-coding"],"created_at":"2025-06-06T01:07:41.903Z","updated_at":"2025-06-28T17:31:45.121Z","avatar_url":"https://github.com/Dumb-Kid-Root.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Espada - AI-Powered Code Generation Tool\n\nA powerful and flexible AI code generation tool that helps developers create, modify, and improve code using advanced language models. Espada streamlines the development process by leveraging AI to generate high-quality, maintainable code based on natural language descriptions.\n\n## 🌟 Features\n\n- **Interactive CLI Interface**: \n  - User-friendly command-line interface for code generation\n  - Real-time feedback and progress indicators\n  - Customizable output formatting\n  \n- **Multiple Model Support**: \n  - Works with various AI models including GPT-4, Claude\n  - Flexible model switching for different tasks\n  - Optimized prompts for each model type\n  \n- **File Selection**: \n  - Smart file selection system with glob pattern support\n  - Intelligent context gathering from related files\n  - Customizable file inclusion/exclusion patterns\n  \n- **Learning System**: \n  - Built-in learning capabilities to improve code generation over time\n  - Feedback incorporation for better results\n  - Historical pattern recognition\n  \n- **Project Management**: \n  - Efficient project organization and metadata management\n  - Version control integration\n  - Project templates and scaffolding\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- Python 3.11 or higher (3.12 recommended)\n- Poetry for dependency management\n- OpenAI API key or Anthropic API key\n- Git version 2.25 or higher\n- 4GB RAM minimum (8GB recommended)\n- Internet connection for API access\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/VinsmokeSomya/Vibe-Coder.git\ncd Vibe-Coder\n```\n\n2. Install dependencies using Poetry:\n```bash\n# Install Poetry if not already installed\ncurl -sSL https://install.python-poetry.org | python3 -\n```\n\n```bash\n# Install project dependencies\npoetry install\n```\n\n```bash\n# Verify installation\npoetry run python -c \"import espada; print(espada.__version__)\"\n```\n\n3. Set up your environment variables:\n```bash\n# Create environment file\ncp .env.template .env\n```\n\n```bash\n# Edit .env with your configuration\nOPENAI_API_KEY=your_api_key_here\nANTHROPIC_API_KEY=your_anthropic_key_here  # Optional\nMODEL_NAME=gpt-4\nDEBUG_MODE=false\nLOG_LEVEL=INFO\n```\n\n### Usage\n\n1. Create a new project:\n```bash\n# Basic project creation\npoetry run espada projects/your-project\n```\n\n2. Run with specific model:\n```bash\n# Using GPT-4\npoetry run espada projects/your-project --model gpt-4\n```\n\n```bash\n# Using Claude\npoetry run espada projects/your-project --model claude-2\n```\n\n## 📁 Project Structure\n\n```\nespada/\n├── applications/        # Application-specific code\n│   └── cli/           # CLI implementation\n├── core/              # Core functionality\n│   ├── ai.py         # AI model integrations and interactions\n│   ├── base_agent.py # Base agent implementation\n│   ├── chat_to_files.py # Chat to file conversion logic\n│   ├── diff.py       # Code diffing functionality\n│   ├── git.py        # Git integration\n│   ├── linting.py    # Code linting utilities\n│   ├── prompt.py     # Prompt management\n│   ├── project_config.py # Project configuration\n│   └── token_usage.py # Token usage tracking\n├── tools/            # Tool implementations\n│   ├── custom_steps.py # Custom execution steps\n│   └── supported_languages.py # Language support definitions\n├── preprompts/       # Predefined prompts\n└── benchmark/        # Benchmarking tools\n```\n\n## 🔧 Configuration\n\nThe project can be configured through:\n\n### Environment Variables (.env)\n- `OPENAI_API_KEY`: Your OpenAI API key\n- `MODEL_NAME`: Default model to use\n- `DEBUG_MODE`: Enable debug logging\n- `LOG_LEVEL`: Logging verbosity\n\n\n\n### Command Line Arguments\n- `--model`: Override model selection\n- `--temperature`: Adjust generation temperature\n- `--max-tokens`: Set token limit\n- `--debug`: Enable debug mode\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help:\n\n1. Fork the repository\n2. Create a feature branch\n3. Commit your changes\n4. Push to the branch\n5. Open a Pull Request\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and development process.\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- OpenAI for GPT models and API\n- Anthropic for Claude models\n- The open-source community\n- All contributors and maintainers\n\n## 📫 Contact \u0026 Support\n\n- GitHub Issues: [Report a bug](https://github.com/VinsmokeSomya/Vibe-Coder/issues)\n- Documentation: [Coming soon...]()\n\n\n## 🚀 Future Plans\n\n- Enhanced model support\n- Web interface\n- Cloud deployment options\n- Collaborative features\n- Advanced code analysis\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDumb-Kid-Root%2FVibe-Coder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDumb-Kid-Root%2FVibe-Coder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDumb-Kid-Root%2FVibe-Coder/lists"}