CommuniSense
CommuniSense is a community-adaptive moderation layer built on Gemini.
Core trick
Gemini reads community rules and sample threads to build a moderation profile, then scores messages against it plus global safety rules.
Description
CommuniSense is a community-adaptive moderation layer built on Gemini.
Most moderation systems assume language norms are universal. In reality, communities speak differently - different dialects, slang, reclaimed language, and cultural context all affect how messages are interpreted. Current toxicity detectors do not account for that and now people are getting **banned for speaking their dialect**, while harmful language specific to a community goes undetected.
CommuniSense uses a Gemini-powered agent to study a community, it's rules and discussions, and infer a moderation profile. Instead of relying on static keyword filters, it predicts how members of that community would react to a message and combines this with broader safety rules.
The result is context-aware moderation that understands your community.
README excerpt
# CommuniSense 🛡️
**CommuniSense** is a one-click community-adaptive moderation and safety layer for Gemini-powered systems. It analyzes community norms from URLs or files to generate a tailored Moderation Constitution, protecting specialized communities without stifling their authentic culture.
---
## 🚀 One-Click Startup (Windows)
The simplest way to launch both the **Backend** and **Frontend** simultaneously:
1. Open the project folder.
2. Double-click **`start.bat`**.
3. Two terminal windows will open:
* **Window 1**: Sets up the Python environment and starts the **FastAPI Backend** (Port 8000).
* **Window 2**: Installs packages and starts the **Next.js Frontend** (Port 3000).
---
## 🛠️ Manual Setup
### 1. Backend Setup & Startup
Ensure you have the backend running first so the frontend can communicate with it.
```bash
cd backend
python -m venv venv
# Windows:
venv\Scripts\activate
# Unix/macOS:
source venv/bin/activate
pip install -r requirements.txt
playwright install chromium
# Launch the Backend
uvicorn main:app --reload
```
### 2. Frontend Setup & Startup
```bash
# In the root directory (hackathonn/)
npm install
npm run dev
```
---
## 📖 How to Use
1. **Ingestion**: Paste a URL (e.g., a forum or rules page) or upload a file (TXT, PDF, CSV, JSON).
2. **Community Profile**: CommuniSense infers behavioral norms, tone, and sensitive zones.
3. **Moderation Constitution**: View the adaptive guidelines generated specifically for that communit