# Vega Framework
An enterprise-ready Python framework that enforces Clean Architecture for building maintainable and scalable applications.
## Features
- ✅ **Automatic Dependency Injection** - Zero boilerplate, type-safe DI
- ✅ **Clean Architecture Patterns** - Interactor, Mediator, Repository, Service
- ✅ **Scope Management** - Singleton, Scoped, Transient lifetimes
- ✅ **Type-Safe** - Full type hints support
- ✅ **Framework-Agnostic** - Works with any domain (web, AI, IoT, fintech, etc.)
- ✅ **CLI Scaffolding** - Generate projects and components instantly
- ✅ **Lightweight** - No unnecessary dependencies
## Installation
```bash
pip install vega-framework
```
## Quick Start
```bash
# Create new project
vega init my-app
# Generate components
vega generate entity User
vega generate repository UserRepository
vega generate interactor CreateUser
# Create FastAPI project
vega init my-api --template fastapi
```
## CLI Commands
### Initialize Project
```bash
vega init <project_name> [--template basic|fastapi|ai-rag] [--path .]
```
Creates a new Vega project with Clean Architecture structure:
- `domain/` - Entities, repositories, services, interactors
- `application/` - Mediators and workflows
- `infrastructure/` - Repository and service implementations
- `config.py` - DI container setup
- `settings.py` - Application configuration
### Generate Components
```bash
vega generate entity <Name>
vega generate repository <Name> [--impl memory|sql]
vega generate service <Name>
vega generate interactor <Name>
vega generate mediator <Name>
vega generate web fastapi
```
### Validate Project
```bash
vega doctor [--path .]
```
Validates project structure, DI configuration, and architecture compliance.
## Use Cases
Perfect for:
- AI/RAG applications
- E-commerce platforms
- Fintech systems
- Mobile backends
- Microservices
- CLI tools
- Any Python application requiring clean architecture
## License
MIT
## Contributing
Contributions welcome! This framework is extracted from production code and battle-tested.
Raw data
{
"_id": null,
"home_page": "https://github.com/your-org/vega-framework",
"name": "vega-framework",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "clean-architecture, dependency-injection, framework, python, async, vega",
"author": "Roberto Ferro",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/a0/15/761a02da688ed8dd02263dc9a3271774666c2daa178a97f29c401d9392b7/vega_framework-0.1.4.tar.gz",
"platform": null,
"description": "# Vega Framework\n\nAn enterprise-ready Python framework that enforces Clean Architecture for building maintainable and scalable applications.\n\n## Features\n\n- \u2705 **Automatic Dependency Injection** - Zero boilerplate, type-safe DI\n- \u2705 **Clean Architecture Patterns** - Interactor, Mediator, Repository, Service\n- \u2705 **Scope Management** - Singleton, Scoped, Transient lifetimes\n- \u2705 **Type-Safe** - Full type hints support\n- \u2705 **Framework-Agnostic** - Works with any domain (web, AI, IoT, fintech, etc.)\n- \u2705 **CLI Scaffolding** - Generate projects and components instantly\n- \u2705 **Lightweight** - No unnecessary dependencies\n\n## Installation\n\n```bash\npip install vega-framework\n```\n\n## Quick Start\n\n```bash\n# Create new project\nvega init my-app\n\n# Generate components\nvega generate entity User\nvega generate repository UserRepository\nvega generate interactor CreateUser\n\n# Create FastAPI project\nvega init my-api --template fastapi\n```\n\n## CLI Commands\n\n### Initialize Project\n\n```bash\nvega init <project_name> [--template basic|fastapi|ai-rag] [--path .]\n```\n\nCreates a new Vega project with Clean Architecture structure:\n\n- `domain/` - Entities, repositories, services, interactors\n- `application/` - Mediators and workflows\n- `infrastructure/` - Repository and service implementations\n- `config.py` - DI container setup\n- `settings.py` - Application configuration\n\n### Generate Components\n\n```bash\nvega generate entity <Name>\nvega generate repository <Name> [--impl memory|sql]\nvega generate service <Name>\nvega generate interactor <Name>\nvega generate mediator <Name>\nvega generate web fastapi\n```\n\n### Validate Project\n\n```bash\nvega doctor [--path .]\n```\n\nValidates project structure, DI configuration, and architecture compliance.\n\n## Use Cases\n\nPerfect for:\n\n- AI/RAG applications\n- E-commerce platforms\n- Fintech systems\n- Mobile backends\n- Microservices\n- CLI tools\n- Any Python application requiring clean architecture\n\n## License\n\nMIT\n\n## Contributing\n\nContributions welcome! This framework is extracted from production code and battle-tested.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Enterprise-ready Python framework that enforces Clean Architecture for building maintainable and scalable applications.",
"version": "0.1.4",
"project_urls": {
"Documentation": "https://vega-framework.readthedocs.io",
"Homepage": "https://github.com/your-org/vega-framework",
"Repository": "https://github.com/your-org/vega-framework"
},
"split_keywords": [
"clean-architecture",
" dependency-injection",
" framework",
" python",
" async",
" vega"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "965d73693c2b2632d01360c1c5406ca37425005791a7d8bf9a16e79c1ca1f473",
"md5": "9ed6ac24c52b3dfcc39ed5e4c63c4860",
"sha256": "76f0fae67dc76d8cf6998bf2d83c2a432de1ed40a975259d8e9f33b1cdc1af96"
},
"downloads": -1,
"filename": "vega_framework-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9ed6ac24c52b3dfcc39ed5e4c63c4860",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 38500,
"upload_time": "2025-10-06T20:35:41",
"upload_time_iso_8601": "2025-10-06T20:35:41.242006Z",
"url": "https://files.pythonhosted.org/packages/96/5d/73693c2b2632d01360c1c5406ca37425005791a7d8bf9a16e79c1ca1f473/vega_framework-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a015761a02da688ed8dd02263dc9a3271774666c2daa178a97f29c401d9392b7",
"md5": "c36b7cd8d502d207bfc785ab0bb83525",
"sha256": "5629167ada569f8946f4af12831be1192ba0e022682009bf25a16a51b106a3b5"
},
"downloads": -1,
"filename": "vega_framework-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "c36b7cd8d502d207bfc785ab0bb83525",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 30389,
"upload_time": "2025-10-06T20:35:42",
"upload_time_iso_8601": "2025-10-06T20:35:42.311409Z",
"url": "https://files.pythonhosted.org/packages/a0/15/761a02da688ed8dd02263dc9a3271774666c2daa178a97f29c401d9392b7/vega_framework-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-06 20:35:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "your-org",
"github_project": "vega-framework",
"github_not_found": true,
"lcname": "vega-framework"
}
JSON
