Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Adds packages to syspath so they can be used as git submodules instead of pip packages. Should be only used in development.

Project Description

Django Git Submodules

Django Submodules is a simple Django app that allows you
to manage apps as git submodules instead of pip.
This allows you to have a local development version of
third-party packages and merge changes from upstream.

Ideally should only be used in development.
These changes should be pushed back to the package repository
and installed with pip on production.

Quick start
1. Install django-git-submodules::

pip install django-git-submodule

2. Clone the the package you want on your project root::

git clone

3. Import the app in your ``::

from dj_git_submodule import submodule

4. Now you should be able to add the app to `INSTALLED_APPS` and have django find it successfully.

5. If you need to import multiple apps, you can create a file alongside your requirements.txt::
from dj_git_submodule import submodule

Release History

This version
History Node


Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate