Ansible Runner — FastAPI

A FastAPI rewrite of the Django Ansible Runner, with identical UI and functionality.

Setup

pip install -r requirements.txt

Run (development)

uvicorn main:app --reload
# → http://127.0.0.1:8000

Run (accessible from outside localhost)

uvicorn main:app --host 0.0.0.0 --port 8000

Interactive API Docs

FastAPI auto-generates docs at:

• Swagger UI: http://127.0.0.1:8000/docs
• ReDoc: http://127.0.0.1:8000/redoc

Project Structure

fastapi_ansible_runner/
├── main.py               # FastAPI app, routes, SSE streaming
├── requirements.txt
├── templates/
│   └── index.html        # Same UI as Django version
├── playbooks/            # ← Drop .yml playbooks here
│   ├── ping_hosts.yml
│   ├── system_info.yml
│   ├── disk_check.yml
│   └── update_packages.yml
└── static/               # Optional static assets

Key differences from the Django version

	Django	FastAPI
Entry point	manage.py runserver	uvicorn main:app
CSRF protection	Built-in middleware	Not needed (JSON API)
Async streaming	StreamingHttpResponse	StreamingResponse + asyncio
Auto API docs	✗	✓ /docs and /redoc
Config files	settings.py + app structure	Single main.py
Template engine	Django templates	Jinja2