Home

Mallo Wiki

Welcome to the Mallo framework documentation.

Mallo is a lightweight, customizable Python web framework with a small core, built-in live reload, templates, routing, static files, middleware, and customizable error pages.

Start Here

1. Getting Started
2. Configuration
3. Routing
4. Templates
5. Requests and Responses
6. Middleware and Hooks
7. Sessions and CSRF
8. Error Handling
9. Database
10. CLI
11. Deployment
12. Troubleshooting
13. Contributing

---

Pages

1. Getting-Started.md
2. Configuration.md
3. Routing.md
4. Templates.md
5. Static-Files.md
6. Requests-Responses.md
7. Middleware-Hooks.md
8. Sessions-CSRF.md
9. Error-Handling.md
10. Hot-Reload.md
11. Database.md
12. CLI.md
13. Deployment.md
14. Troubleshooting.md
15. Contributing.md

---

Advantages

1. Small, readable core that you can understand quickly
2. Fast local iteration with built-in live reload
3. Clean routing, typed params, and simple URL building
4. Lightweight template engine with clear syntax
5. Built-in static files and friendly error pages
6. Middleware and hooks without extra ceremony

---

Why Use Mallo

Use Mallo if you want a framework that is:

1. Minimal but practical for real apps
2. Easy to learn and easy to extend
3. Friendly for teaching, prototyping, or small production systems
4. Clear about what it does and how it does it

---

How Mallo Differs From Other Frameworks

Compared to larger frameworks (Flask, Django, FastAPI), Mallo is:

1. Smaller in core and easier to read end-to-end
2. Less magic, more explicit behavior
3. Focused on learning, customization, and clarity
4. Opinion-light, so you can shape the architecture

Compared to micro frameworks, Mallo includes:

1. Built-in template engine
2. Built-in error pages
3. Built-in hot reload
4. Built-in middleware and groups

---

Comparison Table

Feature	Mallo	Flask	Django	FastAPI
Core size / readability	Small, easy to read	Small/medium	Large	Medium
Learning curve	Low	Low	Medium/high	Medium
Built-in templates	Yes	Jinja via extensions	Yes	No (uses Jinja or others)
Built-in ORM	No	No	Yes	No
Routing style	Decorators	Decorators	URLconf + views	Decorators
Type hints focus	Light	Light	Light	Strong
Auto docs (OpenAPI)	No	No	No	Yes
Live reload	Built-in	Extensions	Extensions	Extensions
Error pages	Built-in	Custom	Built-in	Custom
Middleware	Built-in	Extensions	Built-in	Built-in
Best for	Learning, small apps, customization	General micro apps	Large, batteries-included	APIs and async services