Flaxon 0.3.0 and Teloce-Py 0.3.0 are available on PyPI. Release instructions are maintained on this site; source links identify the framework snapshot. Check version and upgrade guidance.

Framework source · Markdown

Flaxon Technical Passport

Project Identity & Technical Specification

This document provides a high-level overview of the Flaxon framework, including its architecture, supported platforms, compatibility, release policy, and technical specifications.

Project Information

Property Value
Project Flaxon
Type Python Web Framework
License MIT
Language Python 3
Architecture ASGI
Repository https://github.com/aldanedev-create/Flaxon-Backend-Framework
Documentation https://flaxon-website.vercel.app/docs
Website https://flaxon-website.vercel.app
Package Manager pip
Distribution PyPI

Vision

Flaxon is an asynchronous-first Python web framework focused on developer productivity, high performance, clean architecture, and a first-class plugin ecosystem.

Goals include:

  • Modern API design
  • Excellent developer experience
  • Type-safe programming
  • Production readiness
  • Framework extensibility
  • Batteries included
  • Fast startup time
  • Minimal boilerplate

Supported Python Versions

Version Status
Python 3.10 ✅ Supported
Python 3.11 ✅ Supported
Python 3.12 ✅ Supported
Python 3.13 ✅ Supported
Python 3.14+ Experimental

Supported Operating Systems

Platform Supported
Windows ✅
Linux ✅
macOS ✅
WSL ✅
Docker ✅

Application Interface

Flaxon supports:

  • HTTP
  • HTTPS
  • WebSockets
  • ASGI Lifespan
  • Streaming Responses
  • Background Tasks
  • Static Files
  • Template Rendering
  • GraphQL
  • Server-Sent Events (SSE)

ASGI Servers

Recommended servers:

Server Status
Uvicorn ✅ Recommended
Hypercorn ✅
Daphne ✅
Granian ✅
Gunicorn + Uvicorn Workers ✅

Built-in Features

  • Routing
  • Middleware
  • Dependency Injection
  • Validation
  • Authentication
  • Sessions
  • JWT
  • Templates (Jinax)
  • WebSockets
  • Background Tasks
  • Static Files
  • Configuration System
  • Plugin Manager
  • Testing Utilities
  • CLI
  • Admin Dashboard
  • GraphQL
  • Security Utilities

Plugin Ecosystem

Official plugins include:

Plugin Purpose
flaxon-ai AI integrations
flaxon-mobile Mobile backend
flaxon-fyr Fyr frontend integration
flaxon-oauth-google Google OAuth
flaxon-inertia Inertia.js support
flaxon-debug-toolbar Development tools
flaxon-sentry Error monitoring
flaxon-pytest Testing
flaxon-spring-boot Spring-style architecture
flaxon-ffd FastAPI/Flask/Django bridge

Performance Goals

Target characteristics:

  • Fast routing
  • Async-first architecture
  • Low memory usage
  • Startup optimized
  • Zero unnecessary dependencies
  • Efficient request handling
  • High concurrency support

Security Features

  • JWT Authentication
  • Session Authentication
  • CSRF Protection
  • Password Hashing
  • API Keys
  • Rate Limiting
  • Security Headers
  • Input Validation
  • Role Permissions
  • Permission System

Template Engine

Default engine:

Jinax

Features:

  • Async rendering
  • Template inheritance
  • Filters
  • Custom functions
  • Components
  • Auto escaping
  • Hot reload
  • Global variables

CLI

Example commands:

flaxon new app
flaxon run app:app
flaxon doctor app:app
flaxon routes app:app
flaxon generate route
flaxon generate schema
flaxon plugins list

Dependency Policy

Core framework keeps dependencies minimal.

Optional functionality is provided through plugins.

flaxon
├── Core
├── Routing
├── HTTP
├── Templates
├── Validation
├── CLI
└── Plugins

Code Style

Recommended:

  • Black
  • Ruff
  • isort
  • mypy

Formatting:

  • 4 spaces
  • UTF-8
  • Type hints encouraged
  • Async where appropriate

Documentation Standards

Documentation includes:

  • API Reference
  • Examples
  • Tutorials
  • Migration Guides
  • Plugin Guides
  • Architecture Documentation
  • Security Guides
  • Deployment Guides

Testing

Supported:

  • pytest
  • unittest
  • Async testing
  • HTTP testing
  • WebSocket testing
  • Fixtures
  • Factories

Deployment

Recommended platforms:

  • Docker
  • Render
  • Railway
  • Fly.io
  • DigitalOcean
  • Azure
  • AWS
  • Google Cloud
  • Kubernetes

Versioning

Flaxon follows Semantic Versioning.

MAJOR.MINOR.PATCH

Example:

1.0.0
1.1.0
1.1.5
2.0.0

Compatibility Promise

Minor releases:

  • Backward compatible

Patch releases:

  • Bug fixes only

Major releases:

  • May introduce breaking changes
  • Migration guide provided

Stability Levels

Level Meaning
Stable Production ready
Beta Feature complete
Alpha Experimental
Preview Early testing
Deprecated Scheduled for removal

Release Channels

  • Stable
  • Beta
  • Nightly

Long-Term Support (LTS)

LTS releases receive:

  • Security updates
  • Bug fixes
  • Critical patches

No new features.

Coding Principles

Flaxon emphasizes:

  • Explicit over implicit
  • Async by default
  • Small core
  • Extensible architecture
  • Clear APIs
  • Strong typing
  • Developer-first experience

Repository Layout

flaxon/
├── flaxon/
├── docs/
├── examples/
├── tests/
├── benchmarks/
├── scripts/
├── plugins/
├── website/
└── pyproject.toml

Maintenance Status

Current status:

  • ✅ Actively Developed
  • ✅ Community Supported
  • ✅ Open Source
  • ✅ Production Focused

Support

Documentation:

https://flaxon-website.vercel.app/docs

Website:

https://flaxon-website.vercel.app

GitHub:

https://github.com/aldanedev-create/Flaxon-Backend-Framework

Issues:

https://github.com/aldanedev-create/Flaxon-Backend-Framework/issues

Credits

Created and maintained by the Flaxon contributors.

Thank you to everyone who helps improve the framework through code, documentation, bug reports, discussions, and community feedback.

Simple Python. Serious Applications.