Metadata-Version: 2.4
Name: modmail.py
Version: 5.0a1
Summary: A Discord Modmail bot.
Keywords: discord,discord-bot,modmail,python,discord.py,discord-modmail
Author: Taaku18
Author-email: Taaku18 <taku@modmail.dev>
License-Expression: AGPL-3.0-or-later
License-File: LICENSE.txt
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: AsyncIO
Classifier: Environment :: Console
Classifier: Natural Language :: English
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Communications :: Conferencing
Classifier: Typing :: Typed
Requires-Dist: discord-py==2.6.4
Requires-Dist: rich~=14.2.0
Requires-Dist: pydantic~=2.12.0
Requires-Dist: pydantic-settings~=2.12.0
Requires-Dist: packaging
Requires-Dist: pyyaml~=6.0.3
Requires-Dist: fluent-runtime~=0.4.0
Requires-Dist: beanie[zstd]~=2.0.0 ; extra == 'mongodb'
Requires-Dist: discord-py[speed]==2.6.4 ; extra == 'speed'
Requires-Dist: uvloop>=0.22.1 ; sys_platform != 'win32' and extra == 'speed'
Requires-Dist: sqlalchemy[asyncio,aiosqlite]~=2.0.45 ; extra == 'sqlite'
Requires-Dist: alembic~=1.17.2 ; extra == 'sqlite'
Requires-Python: ==3.14.*
Project-URL: Changelog, https://github.com/modmail-dev/Modmail/blob/master/CHANGELOG.md
Project-URL: Documentation, https://docs.modmail.dev
Project-URL: Funding, https://buymeacoffee.com/modmaildev
Project-URL: Issues, https://github.com/modmail-dev/modmail/issues
Project-URL: Repository, https://github.com/modmail-dev/modmail
Provides-Extra: mongodb
Provides-Extra: speed
Provides-Extra: sqlite
Description-Content-Type: text/markdown

# Modmail v5 - WIP, UNSTABLE BUILD

> [!CAUTION]
> This build of Modmail is currently a work in progress and is considered highly unstable and lacks essential features.
> 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.
>
> No migration effort will be made between pushes, bugs and vulnerabilities are expected, and data loss may occur if used.
> We are also not accepting contributions through issues and pull requests for this branch at this time.

1. Copy `config.yaml.example` and rename it to `config.yaml`, then edit it with your settings
2. 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
   - Replace `DBTYPE` with `mongodb` or `sqlite`, only these two are supported at the moment
3. Start the bot with `uv run python start.py`

Please note that the database structure may change at any time, and database migrations between v5 alpha development versions are not available.
You will need to drop the database when the structure changes.

### Short-Term TODOs

- [x] Forum implementation, alternative to category/channel structure
- [x] Implement log channel message
- [ ] Convert certain embeds to use component v2
- [ ] "Custom locale" to allow overriding specific locale strings without editing language files
- [ ] Proper pytest unit tests (see how other projects do it)
- [ ] pyinstaller or nuitka compiled build, also with an installer
- [ ] Message attachment support (linked attachment to storage channel)

## Acknowledgements

The current release of Modmail (v5) is a complete relicensed rewrite of the original Modmail bot.
Special thanks to the original Modmail dev team (kyb3r, fourjr, Taaku18) for their work,
and to the contributors of the original Modmail bot for their help in making this project possible.
