Django-CRM

<p align="right">
<a href="https://github.com/DjangoCRM/django-crm/blob/main/README.md">English</a> |
<a href="https://github.com/DjangoCRM/django-crm/blob/main/docs/README/README-hindi.md">हिन्दी</a> |
<a href="https://github.com/DjangoCRM/django-crm/blob/main/docs/README/README-spanish.md">Español</a> |
<a href="https://github.com/DjangoCRM/django-crm/blob/main/docs/README/README-chinese.md">中文</a> |
<a href="https://github.com/DjangoCRM/django-crm/blob/main/docs/README/README-portuguese.md">Português</a> |
<a href="https://github.com/DjangoCRM/django-crm/blob/main/docs/README/README-arabic.md">اَلْعَرَبِيَّةُ</a> |
<a href="https://github.com/DjangoCRM/django-crm/blob/main/docs/README/README-french.md">Français</a> |
<a href="https://github.com/DjangoCRM/django-crm/blob/main/docs/README/README-german.md">Deutsch</a> |
<a href="https://github.com/DjangoCRM/django-crm/blob/main/docs/README/README-dutch.md">Nederlands</a> |
<a href="https://github.com/DjangoCRM/django-crm/blob/main/docs/README/README-italian.md">Italiano</a> |
<a href="https://github.com/DjangoCRM/django-crm/blob/main/docs/README/README-ukrainian.md">Українська</a>
</p>

---

# Django-CRM

## Free Open-Source Python CRM with Task Management, Email Marketing, and Analytics

**Django CRM** is a free customer relationship management software built with [Python](https://www.python.org) and [Django](https://www.djangoproject.com), designed for teams that need a self-hosted CRM, CRM task manager, mailing CRM, and CRM analytics software in one extensible platform.

[<img src="https://github.com/DjangoCRM/django-crm/raw/main/docs/pics/deals_screenshot.png" alt="Screenshot Django-CRM" align="center" style="float: center"/>](https://github.com/DjangoCRM/django-crm/blob/main/docs/pics/deals_screenshot.png)

**Project status:** Production / Stable
Used in real business environments for many years.

⭐️ If you find this project useful, **please star this repository** — it helps others discover this free and open-source Python CRM.

---

## Why Django-CRM?

Django CRM combines CRM and task management software, CRM with email integration, and CRM and email marketing software—without proprietary frameworks, vendor lock-in, or SaaS limitations..

### For businesses and end users

* Manage **leads, deals, contacts, tasks, projects, and email campaigns** in one system
* Replace multiple tools with a **single collaborative CRM**
* Gain insights using built-in **CRM analytics software**

### For developers and system integrators

* 100% Python CRM based on the Django framework
* No proprietary UI layer—everything runs on [Django Admin](https://docs.djangoproject.com/en/dev/ref/contrib/admin/)
* Fast customization, predictable upgrades, and simple deployments
* Ideal for **self-hosted CRM** and on-premise installations

---

## Core CRM Features

| CRM & Sales                  | Tasks & Collaboration | Email & Marketing                |
| ---------------------------- | --------------------- | -------------------------------- |
| Lead management              | CRM task manager      | Mailing CRM                      |
| Deal tracking & forecasting  | Projects & subtasks   | CRM and email marketing software |
| Company & contact management | Internal chat         | CRM with email integration       |
| Role-based access control    | Reminders & files     | SMTP / IMAP support              |
| CRM analytics software       | Office memos          | Email campaign automation        |

🔎 Learn more in the [CRM system overview](https://github.com/DjangoCRM/django-crm/blob/main/docs/crm_system_overview.md).

---

## Python CRM Built on Django Admin

Django-CRM is a Python CRM that fully leverages the **Django Admin interface**:

* Adaptive admin templates (desktop & mobile)
* Advanced filtering, sorting, and search
* Object-level permissions (view, add, change, delete)
* Single-page admin documentation

Instead of reinventing a UI framework, Django-CRM focuses on **business logic**, **data integrity**, and **extensibility**—making it ideal **for small and mid-size businesses** looking for a free customer relationship management software they can host and control.

---

## Main Applications

### CRM Application

* Requests (inquiries, incidents)
* Leads and opportunities
* Companies and contact persons
* Deals (sales pipeline)
* Products and payments
* Email messages linked to CRM objects

➡️ Over 20 interconnected CRM models for complex sales workflows.

---

### Tasks & Project Management (CRM Task Manager)

A full **CRM and task management software** module:

* Tasks and subtasks
* Projects as task collections
* Office memos converted into tasks or projects
* Chat, files, reminders, tags
* Individual and team task assignment

🔗 [Task features](https://github.com/DjangoCRM/django-crm/blob/main/docs/django-crm_task_features.md)

---

[<img src="https://github.com/DjangoCRM/django-crm/raw/main/docs/pics/income_summary_thumbnail.png" alt="Analytical crm report" align="right" width="190px" style="float: right"/>](https://github.com/DjangoCRM/django-crm/blob/main/docs/pics/income_summary_screenshot.png)

### Analytics Application (Analytical CRM)

Built-in **CRM analytics software** for actionable insights:

* Sales funnel analysis
* Income summary reports
* Lead source analytics
* Requests Summary

🔗 [Analytics app overview](https://github.com/DjangoCRM/django-crm/blob/main/docs/django-crm_analytics_app_overview.md)

---

### Mailing CRM & Email Marketing

Mailing CRM includes a complete CRM and email marketing software module:

* Email accounts (SMTP / IMAP)
* Email campaigns and newsletters
* Dynamic templates
* Email signatures
* Contact segmentation

This makes Django-CRM suitable as a CRM with email integration and internal email client.

---

## Email Client & Integration

The **built-in email client** supports:

* SMTP and IMAP
* Gmail and other providers
* OAuth 2.0 (two-step authentication)
* Automatic email synchronization

All correspondence is:

* Stored in the CRM database
* Linked to requests, leads, and deals
* Organized using a ticket-style mechanism

---

## Additional Functionality

* Web form integration with reCAPTCHA v3
* Automatic geolocation
* VoIP callback support
* Messenger integration (WhatsApp, Viber, etc.)
* Excel import/export
* Context-aware help pages
* Tooltips and inline documentation

---

## Multilingual & Localization Ready

<img src="https://github.com/DjangoCRM/django-crm/raw/main/docs/site/icons/languages.svg" alt="django logo" width="30" height="30" style="vertical-align: bottom"> Available interface languages:

`ar, cs, de, el, en, es, fr, he, hi, id, it, ja, ko, nl, pl, pt-br, ro, ru, tr, uk, vi, zh-hans`

Full support for:

* Translations
* Time zones
* Locale-specific date and time formats

---

## Why Choose This Free CRM?

* ✅ Free customer relationship management software
* ✅ Fully self-hosted
* ✅ Python & Django-based
* ✅ CRM, tasks, email, and analytics in one system
* ✅ Ideal for SMBs, agencies, and internal enterprise tools
* ✅ No SaaS fees or vendor lock-in
* ✅ Comprehensive unit tests covering ~90% of code for reliability

---

## Getting Started

Django-CRM runs like a standard Django project.

For testing and evaluation:

* No external database required
* SQLite works out of the box

📘 Documentation:

* [Installation & Configuration](https://github.com/DjangoCRM/django-crm/blob/main/docs/installation_and_configuration_guide.md)
* [User Guide](https://github.com/DjangoCRM/django-crm/blob/main/docs/django-crm_user_guide.md)
* [Online Documentation](https://django-crm-admin.readthedocs.io)
* [Changelog](https://github.com/DjangoCRM/django-crm/blob/main/CHANGELOG.md)

---

## Compatibility

* <img src="https://github.com/DjangoCRM/django-crm/raw/main/docs/site/icons/django-logo.svg" alt="django logo" width="30" height="30" style="vertical-align: middle"> Django 6.0+
* <img src="https://github.com/DjangoCRM/django-crm/raw/main/docs/site/icons/python-logo.svg" alt="python logo" width="30" height="30" style="vertical-align: middle"> Python 3.12+
* <img src="https://github.com/DjangoCRM/django-crm/raw/main/docs/site/icons/mysql_logo.svg" alt="mysql logo" width="30" height="30" style="vertical-align: middle"> MySQL 8.0.11+
* <img src="https://github.com/DjangoCRM/django-crm/raw/main/docs/site/icons/postgresql_logo.svg" alt="postgresql logo" width="30" height="30" style="vertical-align: middle"> PostgreSQL 14+

The CRM version compatible with Django 5.2.11 LTS is available [here](https://github.com/DjangoCRM/django-crm/tree/v1.7.x-LTS).

---

## Contributing

Contributions are welcome—features, fixes, and documentation improvements.

📄 See the [Contributing Guide](https://github.com/DjangoCRM/django-crm/blob/main/CONTRIBUTING.md).

---

## License

Released under the **AGPL-3.0** license.
See the [LICENSE](https://github.com/DjangoCRM/django-crm/blob/main/LICENSE) file.

---

## Support Open Source ❤️

If you found this project useful, please please **⭐ star this repository** on GitHub — it helps others find this free Python CRM.