{"id":13557649,"url":"https://github.com/vitorfs/colossus","last_synced_at":"2025-04-04T23:09:19.185Z","repository":{"id":44865969,"uuid":"135829141","full_name":"vitorfs/colossus","owner":"vitorfs","description":"Self-hosted email marketing solution","archived":false,"fork":false,"pushed_at":"2024-01-03T11:55:00.000Z","size":34876,"stargazers_count":531,"open_issues_count":19,"forks_count":131,"subscribers_count":31,"default_branch":"master","last_synced_at":"2025-03-28T22:14:19.653Z","etag":null,"topics":["automation","django","email-automation","email-marketing","mailing","mailing-list","python","python3"],"latest_commit_sha":null,"homepage":"https://colossus.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vitorfs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-06-02T15:25:16.000Z","updated_at":"2025-03-26T14:09:28.000Z","dependencies_parsed_at":"2024-11-04T08:40:42.219Z","dependency_job_id":null,"html_url":"https://github.com/vitorfs/colossus","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitorfs%2Fcolossus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitorfs%2Fcolossus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitorfs%2Fcolossus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitorfs%2Fcolossus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vitorfs","download_url":"https://codeload.github.com/vitorfs/colossus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247261611,"owners_count":20910108,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","django","email-automation","email-marketing","mailing","mailing-list","python","python3"],"created_at":"2024-08-01T12:04:28.150Z","updated_at":"2025-04-04T23:09:19.165Z","avatar_url":"https://github.com/vitorfs.png","language":"Python","readme":"# Colossus\n\n[![Build Status](https://travis-ci.com/vitorfs/colossus.svg?branch=master)](https://travis-ci.com/vitorfs/colossus)\n[![codecov](https://codecov.io/gh/vitorfs/colossus/branch/master/graph/badge.svg)](https://codecov.io/gh/vitorfs/colossus)\n[![Documentation Status](https://readthedocs.org/projects/colossus/badge/?version=latest)](https://colossus.readthedocs.io/en/latest/?badge=latest)\n\nSelf-hosted email marketing solution. Compatible with any SMTP email service.\n\nOne-click deploy to Heroku:\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)\n\n## Screenshots\n\n![Colossus new campaign](https://colossus.readthedocs.io/en/latest/_images/colossus-new-campaign.png)\n\n![Colossus campaigns](https://colossus.readthedocs.io/en/latest/_images/colossus-campaigns.png)\n\n[More Colossus screenshots.](https://colossus.readthedocs.io/en/latest/features.html#screenshots)\n\n## Features\n\n* Create and manage multiple mailing lists;\n* Import lists from other providers (csv files or paste email addresses);\n* Create reusable email templates;\n* Customize sign up pages (subscribe, unsubscribe, thank you page, etc.);\n* Default double opt-in for sign ups;\n* Schedule email campaign to send on a specific date and time;\n* Track email opens and clicks;\n* Change link URL after email is sent;\n* Reports with geolocation;\n* Compatible with Mailgun, SendGrid, Mandrill, or any other SMTP email service.\n\n## Quickstart\n\nIf you want to have a quick look or just run the project locally, you can get started by either forking this repository\nor just cloning it directly:\n\n```commandline\ngit clone git@github.com:vitorfs/colossus.git\n```\n\nIdeally, create a [virtualenv](https://docs.python-guide.org/dev/virtualenvs/) and install the projects dependencies:\n\n```commandline\npip install -r requirements/development.txt\n```\n\nCreate a local database:\n\n```commandline\npython manage.py migrate\n```\n\nStart development server:\n\n```commandline\npython manage.py runserver\n```\n\nOpen your browser and access the setup page to create an admin account:\n\n```commandline\nhttp://127.0.0.1:8000/setup/\n```\n\nPS: Campaign scheduling will not work out-of-the-box. You need to install a message broker and [setup Celery](https://simpleisbetterthancomplex.com/tutorial/2017/08/20/how-to-use-celery-with-django.html) properly.\n\n## Tech Specs\n\n* Python 3.6\n* Django 2.1\n* PostgreSQL 10\n* Celery 4.2\n* RabbitMQ 3.7\n* Bootstrap 4 \n* jQuery 3.3\n\nPostgreSQL and RabbitMQ are soft dependencies. Other databases (supported by Django) can easily be used as well as other \nmessage broker compatible with Celery.\n\nThe jQuery library is more of a Bootstrap dependency. There is very little JavaScript code in the project. For the most \npart the code base is just plain Django and HTML templates. \n\nComplete list of Python dependencies can be found in the requirements files.\n\n## Documentation\n\nThis is just a pre-release of the project and I still have to work on a proper documentation and user guides.\n\nFor now you will only find documentation of the internal APIs in the source code.\n\n[colossus.readthedocs.io](https://colossus.readthedocs.io)\n\n## Who's using Colossus?\n\nRight now just myself. I'm currently using it for my blog newsletter at [simpleisbetterthancomplex.com](https://simpleisbetterthancomplex.com/).\n\nHere is how my sign up page looks like: [sibt.co/newsletter](https://sibt.co/newsletter)\n\n## License\n\nThe source code is released under the [MIT License](https://github.com/vitorfs/colossus/blob/master/LICENSE).\n","funding_links":[],"categories":["Python","django"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvitorfs%2Fcolossus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvitorfs%2Fcolossus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvitorfs%2Fcolossus/lists"}