This is a submission for the Redis AI Challenge: Beyond the Cache.
What I Built
I built CleanForum, a complete forum application where Redis 8 is not an accessory, but the central nervous system. It handles every aspect of the forum's data, from post and comment storage to real-time AI-powered spam moderation.
The Challenge: Escaping the "Database Zoo"
In modern web development, we often find ourselves managing a "zoo" of specialized databases. A typical stack might include PostgreSQL for primary data, Elasticsearch for search, a dedicated vector database like Pinecone for AI features, and, of course, Redis for caching. This complexity introduces overhead, synchronization challenges, and increased costs.
For my project, CleanForum, I set out with an ambitious goal: to build a full-featured, AI-powered forum using a single data platform. I wanted to challenge the conventional wisdom that Redis is "just a cache" and prove that with Redis 8, it can be the powerful, unified engine for an entire application.
Key Features at a Glance:
- A Complete, Feature-Rich Forum: Users can create posts with Markdown, engage in discussions through comments, and browse content by categories.
- Transparent AI Spam Protection: The crown jewel of the project. A sophisticated, hybrid system that combines traditional heuristic checks with advanced vector similarity analysis. It doesn't just block spam; it provides moderators with a detailed report explaining why a post was flagged.
- Engaging "Similar Posts" Feature: To increase user retention, the system uses Redis's vector search capabilities to instantly suggest other relevant content, keeping users engaged on the site.
- Instant Full-Text Search: The entire forum is searchable, with results delivered in milliseconds, powered by the same RediSearch index used for AI features.
- Insightful Moderator Panel: A command center where moderators can review flagged content, see detailed spam analysis, and manually manage posts and comments, providing feedback to the system.
Demo
The application is live and fully functional. I invite you to test it out!
- Live Application: forum.premananda.site
- Video Demo:
CleanForum 🛡️
A modern forum with an advanced spam protection system based on FastAPI and Redis Vector Search.
🚀 Features
🔒 Advanced Spam Protection
- Vector analysis using SentenceTransformer (all-MiniLM-L6-v2)
- Heuristic algorithms to detect spam patterns
- Feedback system to improve accuracy
- Redis Vector Sets for fast search of similar posts
- k-NN classification with nearest neighbors voting
🏗️ Technology Stack
- Backend: FastAPI, Python 3.8+
- Database: Redis 7.0+ with Vector Search
- ML model: SentenceTransformer
- Frontend: Tailwind CSS, Vanilla JavaScript
- Templates: Jinja2
📋 Functionality
- ✅ Create and edit posts
- ✅ Comment system
- ✅ Categories and tags
- ✅ Voting and ratings
- ✅ Moderator panel
- ✅ Forum search
- ✅ Automatic spam analysis
- ✅ Statistics and analytics
🛠️ Installation and Launch
Prerequisites
- Python 3.8+
- Redis 8.0+ with Vector Search support
- Docker (optional)
1. Cloning and Installing Dependencies
git clone https://github.com/premananda108/CleanForum.git
# Go to the project directory
cd CleanForum
# Create a…Here are some screenshots showcasing the application in action:
Home Page and Content
Post Page with Related Posts
Moderator Panel with Moderation Queue
Detailed Spam Analysis Report
How I Used Redis 8
Redis 8 is the architectural cornerstone of CleanForum. It allowed me to replace a potential stack of 3-4 different technologies with one elegant and hyper-efficient solution.
1. Redis Hashes as the Primary "Source of Truth" Database
Instead of a traditional SQL database, every core entity in the application is a Redis Hash.
- Posts: Stored in keys like
post:<uuid>, a hash contains the post's title, content, author ID, timestamps, and vote scores. - Users:
user:<uuid>hashes store profile information, roles, and reputation. - Comments:
comment:<uuid>hashes hold comment content and relationships.
This approach provides schema flexibility and the raw performance Redis is famous for. To manage relationships and create feeds, I heavily utilized Sorted Sets (ZSETs). For example, posts:all is a sorted set scored by timestamp, providing an instantly accessible, chronologically sorted list of all posts.
2. RediSearch for Dual-Purpose Search: Vector & Full-Text
This is where the "multi-model" power of Redis truly shines. I use a single RediSearch index to power two fundamentally different types of search.
To optimize this, I implemented a two-hash architecture:
- The "Source of Truth" Hash (
post:<id>): Contains the complete, rich data for a post. - The "Search Index" Hash (
vector:post:<id>): A lightweight, separate hash containing only the data needed for indexing: the vector embedding and pre-processed text.
This separation is key: it keeps the search index incredibly lean and fast, while the main data can be as complex as needed without bloating the index. The index is configured to automatically pick up any new keys with the vector: prefix.
3. The Hybrid AI Engine: My Secret Sauce
The spam detection system is a perfect example of combining Redis features to create something powerful. It’s a two-stage process:
- First Pass - Heuristic Analysis: The system first performs a rapid check for obvious spam indicators: suspicious keywords (
"free","crypto"), excessive capitalization, and patterns common in spam. This is handled in Python. - Second Pass - Vector Similarity Analysis: This is the core of the AI.
- A vector embedding is created from the new post's content.
- A K-Nearest Neighbor (KNN) query (
*=>[KNN k @vector $blob]) is sent to RediSearch to find the most similar posts already in the database. - The system then fetches the current, real-time
is_spamstatus of these "neighbors" directly from their primarypost:<id>hashes. - A weighted score is calculated. If a post is highly similar to several posts that moderators have previously marked as spam, its own spam score skyrockets.
This synergy is incredibly powerful. The user-facing "Similar Posts" feature and the backend security system are powered by the exact same mechanism. It's efficient, elegant, and learns continuously from moderator feedback.
4. Deployment and Infrastructure
To prove that this powerful stack is accessible to everyone, the entire application is running on a modest Debian 12 virtual server with just 4GB of RAM. The Redis database itself is hosted on a free-tier cloud instance. This demonstrates that thanks to Redis's incredible efficiency, you don't need a massive budget or enterprise-grade hardware to build and run a sophisticated, AI-driven application.
Conclusion and Gratitude
This journey with the Redis AI Challenge has been more than just a competition; it has fundamentally changed my perspective on what's possible with a single database. Redis 8 is not just a cache—it is a legitimate, high-performance, multi-model database that can serve as the foundation for complex, modern applications. It challenged my architectural assumptions and enabled me to build a cleaner, faster, and more elegant system than I thought possible.
I want to extend my sincere gratitude to the teams at Redis and DEV.to for organizing this incredible challenge. The opportunity to push the boundaries, learn so much about vector search and AI implementation, and engage with this vibrant community has been an invaluable experience. I'm excited to see what I can build next with these powerful new tools at my fingertips.
Top comments (4)
✅ Fixed bugs in the moderator panel
🚀 Expanded moderation functionality
📄 Added pagination throughout the application
📱 Now works correctly on mobile devices
I invite you to test it out, no registration required!
🔗 forum.premananda.site
🚀 Added a complete video demonstration of CleanForum!
This is a live demonstration of how Redis 8 can replace an entire database stack. The video covers:
🔹 Core forum functionality
🔹 AI spam moderation with vector analysis
🔹 Moderator panel with detailed analytics
🔹 Full-text and semantic search
🔹 Simple local installation
A great opportunity to see Redis 8's modern capabilities in action!
youtu.be/ileUJraNjhk
Looks clean!
Hey everyone! The CleanForum is up and running - you can check it out live right now!
I'm working on a demo video and would love your input: what would you most want to see in action?
Some comments may only be visible to logged-in visitors. Sign in to view all comments.