vorte 1.0.0__tar.gz

vorte-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vorte Framework
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vorte-1.0.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: vorte
+Version: 1.0.0
+Summary: The AI-First Python API Framework. Fast, intelligent, and modular.
+Author-email: Vorte Framework <hello@vorte.dev>
+License: MIT
+Keywords: api,framework,ai,fastapi,async,python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn[standard]>=0.32.0
+Requires-Dist: pydantic[email]>=2.10.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0
+Requires-Dist: asyncpg>=0.30.0
+Requires-Dist: redis>=5.0.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: PyJWT>=2.9.0
+Requires-Dist: passlib[bcrypt]>=1.7.4
+Requires-Dist: python-multipart>=0.0.18
+Requires-Dist: alembic>=1.14.0
+Requires-Dist: cryptography>=44.0.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: aiosqlite>=0.20.0
+Provides-Extra: full
+Requires-Dist: vorte[ai]; extra == "full"
+Requires-Dist: vorte[mpesa]; extra == "full"
+Requires-Dist: vorte[payments]; extra == "full"
+Requires-Dist: vorte[search]; extra == "full"
+Requires-Dist: vorte[storage]; extra == "full"
+Provides-Extra: ai
+Requires-Dist: openai>=1.60.0; extra == "ai"
+Requires-Dist: anthropic>=0.40.0; extra == "ai"
+Requires-Dist: google-generativeai>=0.8.0; extra == "ai"
+Provides-Extra: mpesa
+Provides-Extra: payments
+Requires-Dist: stripe>=11.0.0; extra == "payments"
+Provides-Extra: search
+Requires-Dist: meilisearch>=0.31.0; extra == "search"
+Provides-Extra: storage
+Requires-Dist: boto3>=1.35.0; extra == "storage"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
+Requires-Dist: httpx>=0.28.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Requires-Dist: mypy>=1.13.0; extra == "dev"
+Dynamic: license-file
+
+# 🌌 Vorte Framework
+
+**The AI-First, Battery-Included Python API Framework.**
+
+Vorte is a high-performance Python framework designed for modern web development, with a specific focus on AI agents, real-time monitoring, and seamless developer experience. It bridges the gap between powerful backends and stunning, real-time administrative interfaces.
+
+---
+
+## ✨ Key Features
+
+- 🚀 **Built-in Dashboard**: A premium Next.js admin panel automatically served at `/vorte/dashboard`.
+- 🧠 **AI-First**: Native support for AI agents, pipelines, and cost tracking out of the box.
+- 🛠️ **Module System**: Highly decoupled architecture—only use what you need.
+- ⚡ **High Performance**: Built on top of FastAPI and Uvicorn for maximum throughput.
+- 📱 **M-Pesa Integration**: First-class support for Safaricom M-Pesa (Daraja) operations.
+- 📊 **Real-time Metrics**: Track traffic, latency, and system health in real-time.
+- 🐳 **Cloud Ready**: Auto-generates Docker and Kubernetes manifests.
+
+---
+
+## 🚀 Quick Start
+
+### 1. Install Vorte
+```bash
+pip install vorte
+```
+
+### 2. Scaffold Your Project
+```bash
+vorte new my-awesome-app
+cd my-awesome-app
+```
+
+### 3. Launch
+```bash
+vorte serve --watch
+```
+Visit `http://localhost:8000/vorte/dashboard` to see your new console!
+
+---
+
+## 🏗️ Architecture
+
+Vorte follows a modular "Core + Plugins" architecture. The core provides the engine, while modules handle specific functionality like AI, Database, and Auth.
+
+```python
+from vorte import Vorte
+
+app = Vorte(auto_load=True)
+
+@app.get("/api/v1/hello")
+async def hello():
+    return {"message": "Welcome to Vorte!"}
+```
+
+---
+
+## 🎨 Dashboard Customization
+
+The dashboard is built with **Next.js**, **Tailwind CSS**, and **Framer Motion**. You can find the source in the `src/` directory if you wish to build custom modules or skins.
+
+---
+
+## 📄 License
+
+Vorte is released under the **MIT License**.
+
+## 🤝 Contributing
+
+We welcome contributions! Please check the issues or submit a pull request.
+
+---
+
+*Built with ❤️ for developers who value speed, aesthetics, and intelligence.*

vorte-1.0.0/README.md

@@ -0,0 +1,74 @@
+# 🌌 Vorte Framework
+
+**The AI-First, Battery-Included Python API Framework.**
+
+Vorte is a high-performance Python framework designed for modern web development, with a specific focus on AI agents, real-time monitoring, and seamless developer experience. It bridges the gap between powerful backends and stunning, real-time administrative interfaces.
+
+---
+
+## ✨ Key Features
+
+- 🚀 **Built-in Dashboard**: A premium Next.js admin panel automatically served at `/vorte/dashboard`.
+- 🧠 **AI-First**: Native support for AI agents, pipelines, and cost tracking out of the box.
+- 🛠️ **Module System**: Highly decoupled architecture—only use what you need.
+- ⚡ **High Performance**: Built on top of FastAPI and Uvicorn for maximum throughput.
+- 📱 **M-Pesa Integration**: First-class support for Safaricom M-Pesa (Daraja) operations.
+- 📊 **Real-time Metrics**: Track traffic, latency, and system health in real-time.
+- 🐳 **Cloud Ready**: Auto-generates Docker and Kubernetes manifests.
+
+---
+
+## 🚀 Quick Start
+
+### 1. Install Vorte
+```bash
+pip install vorte
+```
+
+### 2. Scaffold Your Project
+```bash
+vorte new my-awesome-app
+cd my-awesome-app
+```
+
+### 3. Launch
+```bash
+vorte serve --watch
+```
+Visit `http://localhost:8000/vorte/dashboard` to see your new console!
+
+---
+
+## 🏗️ Architecture
+
+Vorte follows a modular "Core + Plugins" architecture. The core provides the engine, while modules handle specific functionality like AI, Database, and Auth.
+
+```python
+from vorte import Vorte
+
+app = Vorte(auto_load=True)
+
+@app.get("/api/v1/hello")
+async def hello():
+    return {"message": "Welcome to Vorte!"}
+```
+
+---
+
+## 🎨 Dashboard Customization
+
+The dashboard is built with **Next.js**, **Tailwind CSS**, and **Framer Motion**. You can find the source in the `src/` directory if you wish to build custom modules or skins.
+
+---
+
+## 📄 License
+
+Vorte is released under the **MIT License**.
+
+## 🤝 Contributing
+
+We welcome contributions! Please check the issues or submit a pull request.
+
+---
+
+*Built with ❤️ for developers who value speed, aesthetics, and intelligence.*

vorte-1.0.0/pyproject.toml

@@ -0,0 +1,85 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vorte"
+version = "1.0.0"
+description = "The AI-First Python API Framework. Fast, intelligent, and modular."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.11"
+authors = [
+    {name = "Vorte Framework", email = "hello@vorte.dev"},
+]
+keywords = ["api", "framework", "ai", "fastapi", "async", "python"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP :: HTTP Servers",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+dependencies = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "pydantic[email]>=2.10.0",
+    "sqlalchemy[asyncio]>=2.0.0",
+    "asyncpg>=0.30.0",
+    "redis>=5.0.0",
+    "httpx>=0.28.0",
+    "PyJWT>=2.9.0",
+    "passlib[bcrypt]>=1.7.4",
+    "python-multipart>=0.0.18",
+    "alembic>=1.14.0",
+    "cryptography>=44.0.0",
+    "jinja2>=3.1.0",
+    "click>=8.1.0",
+    "python-dotenv>=1.0.0",
+    "aiosqlite>=0.20.0",
+]
+
+[project.optional-dependencies]
+full = [
+    "vorte[ai]",
+    "vorte[mpesa]",
+    "vorte[payments]",
+    "vorte[search]",
+    "vorte[storage]",
+]
+ai = [
+    "openai>=1.60.0",
+    "anthropic>=0.40.0",
+    "google-generativeai>=0.8.0",
+]
+mpesa = []
+payments = ["stripe>=11.0.0"]
+search = ["meilisearch>=0.31.0"]
+storage = ["boto3>=1.35.0"]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.24.0",
+    "httpx>=0.28.0",
+    "ruff>=0.8.0",
+    "mypy>=1.13.0",
+]
+
+[project.scripts]
+vorte = "vorte.cli.main:cli"
+
+[tool.setuptools.packages.find]
+include = ["vorte*"]
+
+[tool.setuptools.package-data]
+"vorte.modules.dashboard" = ["static/**/*"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

vorte-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vorte-1.0.0/setup.py

@@ -0,0 +1,50 @@
+import os
+import subprocess
+import shutil
+from pathlib import Path
+from setuptools import setup
+from setuptools.command.build_py import build_py
+from setuptools.command.sdist import sdist
+
+dashboard_built = False
+
+def build_dashboard():
+    """Build the Next.js dashboard and copy to static directory."""
+    global dashboard_built
+    if dashboard_built:
+        return
+        
+    print("Building Vorte Dashboard...")
+    setup_dir = Path(__file__).parent
+    vorte_dir = setup_dir.parent
+    
+    if not (vorte_dir / "package.json").exists():
+        print(f"Warning: Could not find package.json in {vorte_dir}. Skipping dashboard build.")
+        return
+
+    # Run npm run build
+    print("Running 'npm run build'...")
+    try:
+        # Use shell=True for cross-platform compatibility (especially Windows npm)
+        subprocess.run(["npm", "run", "build"], cwd=vorte_dir, check=True, shell=True)
+    except subprocess.CalledProcessError as e:
+        print(f"Error: Dashboard build failed. {e}")
+        return
+        
+    # Copy out/ to static/
+    out_dir = vorte_dir / "out"
+    static_dir = setup_dir / "vorte" / "modules" / "dashboard" / "static"
+    
+    if out_dir.exists():
+        if static_dir.exists():
+            shutil.rmtree(static_dir)
+        shutil.copytree(out_dir, static_dir)
+        print(f"Dashboard successfully built and copied to {static_dir}")
+    else:
+        print("Warning: out/ directory not found after build.")
+
+
+# Run the build before setup() is called so setuptools sees the new files
+build_dashboard()
+
+setup()

vorte-1.0.0/vorte/__init__.py

@@ -0,0 +1,97 @@
+"""
+Vorte Framework - The AI-First Python API Framework
+=====================================================
+Fast, intelligent, and modular. Built on FastAPI with batteries-included architecture,
+multi-provider AI integration, and production-ready features.
+
+Version: 1.0.0
+License: MIT
+
+Quick Start:
+    from vorte import Vorte
+
+    # Create app with all 21 modules auto-loaded
+    app = Vorte(auto_load=True)
+
+    # Or cherry-pick modules
+    app = Vorte()
+    app.register(AuthModule(), AIModule(), CacheModule())
+
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+"""
+
+__version__ = "1.0.0"
+__author__ = "Vorte Framework"
+__license__ = "MIT"
+
+from vorte.core.app import Vorte
+from vorte.core.module import Module, ModuleRegistry, ModuleMeta, ModuleState, ModulePriority
+from vorte.core.config import Settings, settings
+from vorte.core.response import VorteResponse, success_response, error_response
+from vorte.core.router import router
+from vorte.core.di import Container, Depends, inject
+
+# All 21 built-in modules — directly importable
+from vorte.modules.auth import AuthModule
+from vorte.modules.database import DatabaseModule
+from vorte.modules.ai import AIModule
+from vorte.modules.agents import AgentsModule
+from vorte.modules.cache import CacheModule
+from vorte.modules.queue import QueueModule
+from vorte.modules.search import SearchModule
+from vorte.modules.storage import StorageModule
+from vorte.modules.mailer import MailerModule
+from vorte.modules.notifications import NotificationsModule
+from vorte.modules.mpesa import MpesaModule
+from vorte.modules.payments import PaymentsModule
+from vorte.modules.tenancy import MultiTenancyModule
+from vorte.modules.i18n import I18nModule
+from vorte.modules.security import SecurityModule
+from vorte.modules.webhooks import WebhooksModule
+from vorte.modules.features import FeaturesModule
+from vorte.modules.graphql import GraphQLModule
+from vorte.modules.logging import LoggingModule
+from vorte.modules.sockets import SocketModule
+from vorte.modules.dashboard import DashboardModule
+
+__all__ = [
+    # Core
+    "Vorte",
+    "Module",
+    "ModuleRegistry",
+    "ModuleMeta",
+    "ModuleState",
+    "ModulePriority",
+    "Settings",
+    "settings",
+    "VorteResponse",
+    "success_response",
+    "error_response",
+    "router",
+    "Container",
+    "Depends",
+    "inject",
+    # Built-in Modules
+    "AuthModule",
+    "DatabaseModule",
+    "AIModule",
+    "AgentsModule",
+    "CacheModule",
+    "QueueModule",
+    "SearchModule",
+    "StorageModule",
+    "MailerModule",
+    "NotificationsModule",
+    "MpesaModule",
+    "PaymentsModule",
+    "MultiTenancyModule",
+    "I18nModule",
+    "SecurityModule",
+    "WebhooksModule",
+    "FeaturesModule",
+    "GraphQLModule",
+    "LoggingModule",
+    "SocketModule",
+    "DashboardModule",
+]

vorte-1.0.0/vorte/cli/__init__.py

@@ -0,0 +1,5 @@
+"""Vorte CLI - Command-line interface for Vorte Framework."""
+
+from vorte.cli.main import cli
+
+__all__ = ["cli"]