Thanks for taking the time to contribute! Here's everything you need to get started.
- Check open issues to avoid duplicate work
- For large changes, open an issue first to discuss the approach
- All PRs should target the
mainbranch
# 1. Fork and clone the repo
git clone https://github.com/your-username/Discord-C.AI-Wrapper.git
cd CharacterAI-Discord-Bot
# 2. Install dependencies
pip install -r requirements.txt
# 3. Copy the env file and fill in your token
cp .env.example .env| Type | Pattern | Example |
|---|---|---|
| Feature | feat/short-description |
feat/typing-indicator |
| Bug fix | fix/short-description |
fix/webhook-not-deleted |
| Refactor | refactor/short-description |
refactor/session-manager |
| Docs | docs/short-description |
docs/readme-update |
Before submitting a PR, make sure:
- Code runs without errors (
python bot.py) - No hardcoded tokens, emails, or secrets in the diff
- Comments removed from code (keep code self-explanatory)
-
session_store.jsonis not included in the commit - PR description explains what changed and why
Open an issue and include:
- What you did
- What you expected to happen
- What actually happened (paste the full traceback)
- Python version and OS
Open an issue with the enhancement label and describe:
- The problem you're trying to solve
- Your proposed solution
- Any alternatives you considered
Do not open a public issue for security vulnerabilities.
Reach out privately so it can be patched before disclosure.
By contributing, you agree that your work will be released under the MIT License.