{"id":42621438,"url":"https://github.com/realsuayip/asu","last_synced_at":"2026-01-29T04:22:41.883Z","repository":{"id":41949561,"uuid":"444956422","full_name":"realsuayip/asu","owner":"realsuayip","description":"A comprehensive Django reference project.","archived":false,"fork":false,"pushed_at":"2025-12-28T20:40:20.000Z","size":1423,"stargazers_count":36,"open_issues_count":1,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-31T12:53:37.508Z","etag":null,"topics":["django","python","rest-api","social-networking"],"latest_commit_sha":null,"homepage":"https://asu.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/realsuayip.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-01-05T21:33:57.000Z","updated_at":"2025-12-28T20:40:24.000Z","dependencies_parsed_at":"2024-04-18T21:27:26.382Z","dependency_job_id":"72825695-4a55-4c42-aa7f-42f380d6c646","html_url":"https://github.com/realsuayip/asu","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/realsuayip/asu","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/realsuayip%2Fasu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/realsuayip%2Fasu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/realsuayip%2Fasu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/realsuayip%2Fasu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/realsuayip","download_url":"https://codeload.github.com/realsuayip/asu/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/realsuayip%2Fasu/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28862146,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T22:56:21.783Z","status":"online","status_checked_at":"2026-01-29T02:00:06.714Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["django","python","rest-api","social-networking"],"created_at":"2026-01-29T04:22:37.415Z","updated_at":"2026-01-29T04:22:41.878Z","avatar_url":"https://github.com/realsuayip.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# asu\n\n[![codecov](https://codecov.io/github/realsuayip/asu/branch/main/graph/badge.svg?token=A0BJ9TINW1)](https://codecov.io/github/realsuayip/asu)\n\nDocumentation available at: [https://asu.readthedocs.io](https://asu.readthedocs.io)\n\nThis is a comprehensive Django project for reference. The project roughly\nconstitutes a real-time chat application with **complete** user management (see\nfeature rundown for details).\n\nYou may use this as a base project (for your projects themed as social media\nwebsites, community forums etc.) or you can scrap the parts you don't need and\nbootstrap a highly optimized Django project.\n\n## Major features\n\n* Authentication \u0026 Account Management\n    * OAuth 2.0 (Authorization Code with PKCE \u0026 Client Credentials)\n    * Two-factor authentication\n    * CRU operations\n    * Blocking operations\n    * Following operations\n      * Follow requests\n      * Ability to mark profile as 'private'\n    * Profile pictures\n      * Thumbnail generation\n      * Image validation\n          * Image scaling \u0026 compression on upload\n          * Mime type validation\n* Verifications (all flows employ email confirmation)\n    * Registration flow\n      * No account generation before email validation.\n    * Password reset flow\n    * Email change flow\n* Messaging\n    * CRUD operations\n    * One-to-one conversations \u0026 messaging\n    * Message requests\n    * Read receipts\n    * Ability to disable messages from strangers\n    * Instant messaging with WebSocket\n      *  Ticket-based authentication\n\nNotice that interactions of these features are well-handled. For instance,\nusers with blocking relations may not message each other. You may message\nyour followers without having them accept your message request (and so on).\n\n## Technical details\n\nThe project is an example of a standard Django stack, the components being:\n\n* Postgres (database)\n* Redis (cache \u0026 channel layer)\n* RabbitMQ (message broker)\n* Celery (task queue)\n* Nginx (reverse proxy)\n\nAll of these components are available through Docker setup (for both\nproduction and development environments).\n\nThere is also single-node-ready Kubernetes configuration that can easily be\nadjusted to support multiple nodes.\n\nThe project has a high test coverage and all the major features are\nwell-tested.\n\n## Installation\n\nTo serve the project, you'll at least need Docker with compose plugin\ninstalled. First off, clone the project:\n\n```shell\ngit clone https://github.com/realsuayip/asu\n```\n\nNavigate to the root directory, and run:\n\n````shell\nmake\n````\n\nMakefile also includes helper targets that can execute related Docker\ncommands, if you don't have GNU make at your disposal, you may also use the\ndocker commands directly:\n\n````shell\ndocker-compose -p asu -f docker/docker-compose.yml up\n````\n\nIf you are using it for the first time, it might take a while to set up the\ncontainers. Once the containers are up and running, you may navigate to\n[`127.0.0.1:8000/api/`](http://127.0.0.1:8000/api/) to browse the API.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frealsuayip%2Fasu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frealsuayip%2Fasu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frealsuayip%2Fasu/lists"}