pyxle-framework 0.1.1

Python-first full-stack framework with an intelligent CLI.

The Python full-stack framework.
Server logic in Python. UI in React. One file.

 

---

# pages/index.pyx

@server
async def load(request):
    return {"message": "Hello from Python"}

# --- JSX ---
export default function Home({ data }) {
    return <h1>{data.message}</h1>;
}

Pyxle compiles .pyx files into Python server modules and React client components. @server loaders run on the backend, SSR renders the HTML, React hydrates on the client.

Get started

pip install pyxle-framework
pyxle init my-app && cd my-app
pyxle install
pyxle dev

Open http://localhost:8000.

Features

.pyx files -- Python + React in a single file, split at compile time File-based routing -- pages/ maps to URLs, dynamic segments with [param].pyx SSR -- Server-side rendering via esbuild + React 18 @server / @action -- Typed data loading and form mutations Layouts -- Nested layouts and templates with slot composition Vite HMR -- Fast refresh in development Tailwind -- Pre-configured out of the box Production build -- pyxle build + pyxle serve for deployment

Documentation

Full docs are in the docs/ directory:

• Quick Start
• .pyx Files
• Routing
• Data Loading
• Server Actions
• Layouts
• Deployment
• CLI Reference
• Configuration

CLI

pyxle init <name>     Scaffold a new project
pyxle install         Install Python + Node dependencies
pyxle dev             Development server with HMR
pyxle build           Production build
pyxle serve           Serve the production build

Requirements

Python 3.10+ and Node.js 18+.

Contributing

git clone https://github.com/shivamsn97/pyxle.git
cd pyxle
pip install -e ".[dev]"
pytest

Links

• pyxle.dev
• PyPI
• Issues