⚡ Pyavel - The Laravel-Inspired Python Framework

Powered by Bramha, the creator of structure and flow.

Official Repository: github.com/mintreu/pyavel

---

🚀 Introduction

Pyavel is a modern, lightweight Python framework inspired by Laravel. It gives you structure, flexibility, and power — without the overhead.
Built for developers who want to code fast, stay organized, and love Laravel-style architecture.

---

🧠 Philosophy

“Pyavel is not just a framework — it's Bramha, the code creator.”
Just like Laravel in PHP, Pyavel helps you manage routes, controllers, helpers, and services in Python — all structured in a modular, readable, and extensible way.

---

📦 Features

• ⚙️ Laravel-style routing & controller system
• 🔁 Custom autoloader (no repeated imports)
• 🧱 MVC-style architecture (Models, Views, Controllers)
• 🌱 Bootstrap loader for global config, helpers, and startup
• 🔧 Global helper support (dd(), greet(), now() etc.)
• ⚡ Lightweight and ready for CLI or HTTP extensions
• 🧩 Plugin and service-provider architecture (planned)

---

📁 Project Structure

pyavel/
├── public/                   # Laravel-like public folder
│   └── main.py               # 🎯 Entry point (.exe or python)
├── bramha/                   # Core framework engine (like Laravel's bootstrap + vendor)
│   ├── bootstrap.py          # Loads autoloader, config, globals
│   ├── autoloader.py
│   ├── helpers.py
│   ├── kernel.py             # Core app kernel (service handling, booting)
│   ├── route.py              # Core Route class that loads from routes/*
│   └── ...                   # base_model, traits, service loader, etc.
├── core/                     # Optional: custom app kernel, artisan, etc.
│   └── (optional main.py)    # CLI entry if needed
├── app/                      # Application logic
│   ├── controllers/
│   ├── models/
│   └── services/
├── routes/                   # 📂 User-defined routes
│   ├── web.py
│   ├── api.py
├── config/                   # Settings / env
│   └── settings.json
├── vendor/                   # External packages
└── README.md
---

### 🚀 Getting Started

#### 1. Clone the Repository

```bash
git clone https://github.com/mintreu/pyavel.git
cd pyavel

2. Run the App

python core/main.py

How the Project Runs

Public Entry (public/main.py): Acts as a basic launcher but doesn’t contain special logic.

python public/main.py

Core Execution (core/main.py): This is the actual entry point that initializes the framework and loads the necessary components.

python core/main.py

3. Add a Route in bootstrap.py

from core.router import Router
from app.Http.Controllers.UserController import UserController

Router.add("/login", UserController().login)

---

💻 Example Controller

# app/Controllers/UserController.py

class UserController:
    def login(self):
        return "User login successful"

    def logout(self):
        return "User logged out"

---

⚡ Global Helpers (like Laravel)

dd("Debug this quickly")
print(greet("Krishzzi"))   # → Hello, Krishzzi

No need to import — just call them from anywhere after bootstrap.

---

📚 Roadmap

• Built-in HTTP support (FastAPI or Flask integration)
• Middleware pipeline
• Artisan-like CLI tool
• .env support & auto loader
• View/template system (Jinja2-based)
• Auto route loader from file (like Laravel routes/web.php)
• Plugin & service providers

---

🧘 Powered By Bramha

Pyavel is powered by Bramha, the creative essence. It helps developers start from nothing, and bring structured flow to life — cleanly, modularly, and predictably.

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

👨‍💻 Developed & Maintained by @krishzzi

Inspired by Laravel, built for Python lovers.