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/app.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:

import uvicorn
from movies.endpoints import HomeEndpoint
from movies.tables import Director, Movie
from starlette.routing import Mount, Route, Router

from piccolo_admin.endpoints import create_admin

# 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=HomeEndpoint),
        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.11.0.tar.gz (400.1 kB view details)

Uploaded Source

Built Distribution

piccolo_admin-1.11.0-py3-none-any.whl (406.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: piccolo_admin-1.11.0.tar.gz
  • Upload date:
  • Size: 400.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.10

File hashes

Hashes for piccolo_admin-1.11.0.tar.gz
Algorithm Hash digest
SHA256 65299a41d135ba06e1fa3e134d364d056d1eaf9ab25270e2c5661c6b7395dd0d
MD5 13df1c44ab83f1f396aa7bbe1d51b4e4
BLAKE2b-256 f66a720bb67afc068c3ec20e20fdb3898e3a201c86c5c3fd92e8f469c5cbb3ff

See more details on using hashes here.

File details

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

File metadata

  • Download URL: piccolo_admin-1.11.0-py3-none-any.whl
  • Upload date:
  • Size: 406.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.10

File hashes

Hashes for piccolo_admin-1.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fa97e8bfc09b1e83f953c6f4d0243cc764759f1a1b65244421fb01f80568813f
MD5 6cf2faae2f9322e1051066d09b866004
BLAKE2b-256 f728869fbd86239024d3232b17295699b91f6771f018e8ec9a857f445d707587

See more details on using hashes here.

Supported by

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