vega-framework 0.1.0

Lightweight Python framework for Clean Architecture with automatic dependency injection

Vega Framework

A lightweight Python framework for building applications with Clean Architecture principles.

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

pip install vega-framework

Quick Start

# 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

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

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

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.