{"id":51401984,"url":"https://github.com/modmail-dev/modmail-v5-unstable","last_synced_at":"2026-07-04T07:33:42.909Z","repository":{"id":350575132,"uuid":"1119400163","full_name":"modmail-dev/modmail-v5-unstable","owner":"modmail-dev","description":"Development version of Modmail. Not ready for public usage.","archived":false,"fork":false,"pushed_at":"2026-05-18T22:30:14.000Z","size":8407,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"v5-development","last_synced_at":"2026-05-19T00:48:24.878Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/modmail-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","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":"2025-12-19T08:03:15.000Z","updated_at":"2026-05-18T22:30:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/modmail-dev/modmail-v5-unstable","commit_stats":null,"previous_names":["modmail-dev/modmail-v5-development","modmail-dev/modmail-v5-unstable"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/modmail-dev/modmail-v5-unstable","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modmail-dev%2Fmodmail-v5-unstable","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modmail-dev%2Fmodmail-v5-unstable/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modmail-dev%2Fmodmail-v5-unstable/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modmail-dev%2Fmodmail-v5-unstable/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/modmail-dev","download_url":"https://codeload.github.com/modmail-dev/modmail-v5-unstable/tar.gz/refs/heads/v5-development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modmail-dev%2Fmodmail-v5-unstable/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35114172,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-04T02:00:05.987Z","response_time":113,"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":[],"created_at":"2026-07-04T07:33:42.122Z","updated_at":"2026-07-04T07:33:42.904Z","avatar_url":"https://github.com/modmail-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Modmail v5 - WIP, UNSTABLE BUILD\n\n\u003e [!CAUTION]\n\u003e This build of Modmail is currently a work in progress and is considered highly unstable and lacks essential features.\n\u003e It is not recommended for general usage at this time. Please use the stable v4 release for production environments at https://github.com/modmail-dev/modmail.\n\u003e\n\u003e No migration effort will be made between pushes, bugs and vulnerabilities are expected, and data loss may occur if used.\n\u003e We are also not accepting contributions through issues and pull requests for this branch at this time.\n\n1. Copy `config.yaml.example` and rename it to `config.yaml`, then edit it with your settings\n2. Install [uv](https://docs.astral.sh/uv/getting-started/installation/), then run `uv sync --locked --compile-bytecode --no-default-groups --extra speed --extra DBTYPE` to install the dependencies\n   - Replace `DBTYPE` with one of the supported database backends:\n     - `mongodb` — MongoDB\n     - `sqlite` — SQLite (local file, no server needed)\n     - `postgresql` — PostgreSQL *(untested)*\n     - `mysql` — MySQL *(untested)*\n     - `mariadb` — MariaDB *(untested)*\n3. Start the bot with `uv run python start.py`\n\nPlease note that the database structure may change at any time, and database migrations between v5 alpha development versions are not available.\nYou will need to drop the database when the structure changes.\n\n### Short-Term TODOs\n\n- [x] Forum implementation, alternative to category/channel structure\n- [x] Implement log channel message\n- [ ] Convert certain embeds to use component v2\n- [ ] \"Custom locale\" to allow overriding specific locale strings without editing language files\n- [ ] Proper pytest unit tests (see how other projects do it)\n- [ ] pyinstaller or nuitka compiled build, also with an installer\n- [ ] Message attachment support (linked attachment to storage channel)\n\n## Acknowledgements\n\nThe current release of Modmail (v5) is a complete relicensed rewrite of the original Modmail bot.\nSpecial thanks to the original Modmail dev team (kyb3r, fourjr, Taaku18) for their work,\nand to the contributors of the original Modmail bot for their help in making this project possible.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmodmail-dev%2Fmodmail-v5-unstable","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmodmail-dev%2Fmodmail-v5-unstable","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmodmail-dev%2Fmodmail-v5-unstable/lists"}