99 lines
2.2 KiB
Markdown
99 lines
2.2 KiB
Markdown
|
|
|
|
<img alt="Civita Banner" src="https://github.com/user-attachments/assets/86e0fc72-9d74-4e21-a911-cd5d2a556f90" />
|
|
|
|
Civita is a **Discord moderation and AI-powered bot** built to make communities safe, fun, and engaging.
|
|
With smart **profanity filters**, an **AI assistant**, and an automated **Question of the Day (QOTD)** system powered by AI, Civita combines powerful moderation with next-gen AI interaction.
|
|
|
|
---
|
|
|
|
## What civita means?
|
|
On a good day Civita means “city,” “state,” or “citizenship.” from Latin, on
|
|
a bad day, it means Idiotic Truckload of Shit
|
|
|
|
## Features
|
|
- 🔧 **Moderation Tools**
|
|
- Kick, ban, mute, warn
|
|
- Automated profanity filtering
|
|
- Reaction-based reporting
|
|
- 🤖 **AI Assistant**
|
|
- Chat with Civita using AI
|
|
- Smart responses and server-friendly interaction
|
|
- 📝 **AI-Powered QOTD**
|
|
- Automatically generates interesting questions
|
|
- Keeps your community engaged daily
|
|
- 📢 **Community Tools**
|
|
- Welcome/leave messages
|
|
|
|
---
|
|
|
|
## 📦 Installation
|
|
|
|
### Prerequisites
|
|
- [Node.JS](https://nodejs.org/en)
|
|
- [PnPm]([https://github.com/DisnakeDev/disnake](https://pnpm.io/)) (or NPM but not recommended)
|
|
- A [Discord Bot Token](https://discord.com/developers/applications)
|
|
- An Gemini API key
|
|
|
|
### Setup
|
|
```bash
|
|
# Clone the repository
|
|
git clone https://github.com/OptimiDEV/Civita.git
|
|
cd Civita
|
|
|
|
# Install dependencies
|
|
pnpm install
|
|
|
|
# Run the bot
|
|
pnpm run start
|
|
````
|
|
|
|
---
|
|
|
|
## Configuration
|
|
|
|
1. Rename `.example.env` to `.env`
|
|
2. Fill in your bot token, API keys, and preferences. Example:
|
|
|
|
```.env
|
|
DISCORD_TOKEN="YourDiscordToken"
|
|
GEMINI_API_KEY="YourGEMINIapiKey"
|
|
```
|
|
|
|
---
|
|
|
|
## Documentation
|
|
|
|
https://civita.optimihost.com/docs
|
|
|
|
---
|
|
|
|
## Contributing
|
|
|
|
Contributions are welcome!
|
|
|
|
* Fork the repo
|
|
* Create a feature branch
|
|
* Submit a pull request
|
|
|
|
Please follow the [Security Policy](SECURITY.md) when reporting vulnerabilities.
|
|
|
|
---
|
|
|
|
## Security
|
|
|
|
See [SECURITY.md](SECURITY.md) for supported versions and reporting guidelines.
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
|
|
|
|
---
|
|
|
|
## 💡 Credits
|
|
|
|
Developed with ❤️ by **OptimiDev** and contributors.
|
|
|
|
P.S. do not use the pnpm run web, its in dev :) |