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

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.3.tar.gz (327.1 kB view details)

Uploaded Source

Built Distribution

piccolo_admin-1.1.3-py3-none-any.whl (334.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: piccolo_admin-1.1.3.tar.gz
  • Upload date:
  • Size: 327.1 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.3.tar.gz
Algorithm Hash digest
SHA256 37d71191139119d533ec8864046d9671dfd15e7c2a4a68a83e23027237922653
MD5 8dcce87a6e40105fab215beefbcb317f
BLAKE2b-256 7993431e7cf2d1bbb3a848b103a462ae4275c1f62760f8199e7cfa417724503f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for piccolo_admin-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 a7e0ea5d1b31989d16cb42e941b93b2e792ecdf9f55e525c22a8930edad883ae
MD5 6b78c8ece0751f034135a69cfcaf884a
BLAKE2b-256 ca97e1046f6a516dce6566a6a2cc54655c295563810c452c209dd0d271349292

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