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.7 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

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-0.53.0.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

piccolo_admin-0.53.0-py3-none-any.whl (1.3 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: piccolo_admin-0.53.0.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.7.17

File hashes

Hashes for piccolo_admin-0.53.0.tar.gz
Algorithm Hash digest
SHA256 675a2618a1f5b7c1d77775a879a03d1d9159328d769939f5155b8579d7c8b67b
MD5 3e9aed0971dd6d6f2bdc59f00765fcb7
BLAKE2b-256 e9f56a4965368c09ef83e2bfbf15400bdecd9e413858e509bf1f7e13d6e8a4b1

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for piccolo_admin-0.53.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7814a2cc1b00426466635c3410cfc840324dff16b48988e10d88e9880b850fa9
MD5 daa0669cc69ebadc7cf3bdd45b05fcaf
BLAKE2b-256 758a17635c0015eed0ab82b2435b1c0fa98952436ce2f19bc47cfa3e081945eb

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