Need help with django-sockpuppet?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

314 Stars 21 Forks MIT License 357 Commits 24 Opened issues


Build reactive applications with the django tooling you already know and love.

Services available


Need anything else?

Contributors list

Welcome to Sockpuppet 👋

downloads License: MIT Documentation
semantic-release Tests

🎉 You just discovered an exciting new way to build modern, reactive, real-time apps with Django.

Why should I spend time exploring this? If you use current frontend libraries, such as react, vue or angular you end up creating state for the frontend and then updating state changes in the backend through an api.

This means that you forgo server-rendered html with the advantages that brings + you'll end up with a more complex app overall.

With this library you can still use normal django templates, and any frontend state you change will be directly reflected in the backend. Currently this happens through the use of websockets.

This is the django implementation of the excellent rails library stimulus-reflex, which in turn is inspired by Phoenix LiveView.

Hit me up on twitter if you have any questions. Twitter follow

📚 Documentation

⚡️ Get started

pip install django-sockpuppet

If performance is important you can take advantage lxml parsing

It will typically speed up the round trip by 30-90ms depending on the html

pip install django-sockpuppet[lxml]

Add these into INSTALLED_APPS in

INSTALLED_APPS = [ 'channels', 'sockpuppet' ]

generates scaffolding for webpack.config.js and installs required js dependencies

if you prefer to do that manually read the more thorough documentation

python initial_sockpuppet

scaffolds a new reflex with everything that's needed.

python generate_reflex app_name name_of_reflex

You're almost there, read about how to tie it all together in the quickstart documentation

💙 Community

  • Discord - We share the discord together with stimulus-reflex, and there is a channel dedicated for python/django discussions.
  • django-sockpuppet-expo - Do you want more examples? There code examples of chats, book search, etc ... We accept PRs :)

🛠 Development in the repo

See some common commands that can be useful for development

pip install -r requirements_dev.txt
invoke -l

Try out a minimal example manually

git clone [email protected]:jonathan-s/django-sockpuppet.git
npm install
npm run build:test
python runserver
# visit https://localhost:8000/test

⛑ Running tests locally

The most important tests are integration tests that makes sure that frontend and backend work together in conjunction with each other.

# Install the cypress et al
npm install

Spin up a dev server that uses some fixtures

inv test-server

Run the cypress tests

npm run cypress:run

🔜 Release

pip install -r requirements_dev.txt
invoke release -b feature

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.