Skip to main content

A powerful and modern admin interface / CMS, powered by Piccolo and ASGI.

Project description

Logo

Piccolo Admin

Documentation Status

Piccolo Admin is a powerful admin interface / content management system for Python, built on top of Piccolo.

Screenshot

It was created at a design agency to serve the needs of customers who demand a high quality, beautiful admin interface for their websites. It's a modern alternative to tools like Wordpress and Django Admin.

It's built using the latest technologies, with Vue.js on the front end, and a powerful REST backend.

Some of it's standout features:

  • Powerful data filtering
  • Builtin security
  • Media support, both locally and in S3 compatible services
  • Dark mode support
  • CSV exports
  • Easily create custom forms
  • Works on mobile and desktop
  • Use standalone, or integrate it easily with ASGI apps like FastAPI, and Starlette
  • Multilingual out of box
  • Bulk actions, like updating and deleting data
  • Flexible UI - only show the columns you want your users to see

Try it

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

Local Demo

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

pip install piccolo_admin
admin_demo

And then just launch localhost:8000 in your browser.

To see what happens behind the scenes, see piccolo_admin/example.py.

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

ASGI

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 such as FastAPI and Starlette.

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=['my_site.com'])


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


if __name__ == '__main__':
    uvicorn.run(router)

Full docs

Full documentation is available on Read the docs.

Project details


Release history Release notifications | RSS feed

This version

1.1.1

Download files

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

Source Distribution

piccolo_admin-1.1.1.tar.gz (324.3 kB view details)

Uploaded Source

Built Distribution

piccolo_admin-1.1.1-py3-none-any.whl (330.8 kB view details)

Uploaded Python 3

File details

Details for the file piccolo_admin-1.1.1.tar.gz.

File metadata

  • Download URL: piccolo_admin-1.1.1.tar.gz
  • Upload date:
  • Size: 324.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.11.6

File hashes

Hashes for piccolo_admin-1.1.1.tar.gz
Algorithm Hash digest
SHA256 51095ce09ecefa5f19695d86cfb8d72d96240f8147b2cc01dd59e56f728b71ea
MD5 ffb0d433e05b30c9fc5ed3a97796e38a
BLAKE2b-256 63bfbd5c479eb0c9dc7dff207ee46306ef2f70f8fab1b10352ddcc8d3722b96a

See more details on using hashes here.

File details

Details for the file piccolo_admin-1.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for piccolo_admin-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 367be6623565440055fdb8bb1d8ce5d3ba34527db9390f251b0c7bb7cd6f6e3a
MD5 c2d8a36375c5bcc649caad8725e95594
BLAKE2b-256 c60a76aeee6544a1b3fd3603fa6290d9ebec18809321eac641e64caeda2bb2e7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page