Skip to main content

A simple and powerful admin for Piccolo models, using ASGI.

Project description

Piccolo Admin

Documentation Status

piccolo_admin provides a simple yet powerful admin interface on top of Piccolo tables - allowing you to easily add / edit / filter your data.


Try it

Try it online (username: piccolo, password: piccolo123).

Local Demo

To run a demo locally, using Python 3.7 or above:

pip install piccolo_admin

And then just launch localhost:8000 in your browser.

To see what happens behind the scenes, see piccolo_admin/

In a few lines of code we are able to:

  • Define our models
  • Setup a database
  • Create a REST API
  • Setup a web server and admin interface


Since the admin is an ASGI app, you can either run it standalone like in the demo, or integrate it with a larger ASGI app.

For example, using Starlette routes:

from piccolo_admin.endpoints import create_admin
from starlette.routing import Router, Route
import uvicorn

from my_project.tables import Director, Movie

# The `allowed_hosts` argument is required when running under HTTPS. It's used
# for additional CSRF defence.
admin = create_admin([Director, Movie], allowed_hosts=[''])

router = Router([
    Route(path="/", endpoint=Hello),
    Mount(path="/admin/", app=admin),

if __name__ == '__main__':

Full docs

Full documentation is available on Read the docs.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for piccolo-admin, version 0.11.7
Filename, size File type Python version Upload date Hashes
Filename, size piccolo_admin-0.11.7-py3-none-any.whl (778.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size piccolo_admin-0.11.7.tar.gz (770.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page