Note

Seeking Investment: We are raising funds to expand language support and scale infrastructure. Interested investors can reach out at social.sakshamjoshi@gmail.com.
Note: This public repository contains only a subset of the full Senti-Vox's codebase.

🎭 Senti-Vox

Multilingual Sentiment Analysis at Lightning Speed

A complete package for performing multilingual sentiment analysis with exceptional speed and accuracy. Built on the Bun runtime for rapid, context-free text analysis.

🌐 Live Demo • 📡 API Endpoint • 📚 Documentation

✨ Key Features

• 🚀 Lightning Fast - Powered by Bun runtime for exceptional performance
• 🌍 Multilingual Support - Analyze text in English, Hindi, Marathi, and Tamil
• 🎯 Context-Free Analysis - Accurate sentiment detection without context dependency
• 📊 Comprehensive Results - Get detailed sentiment scores, word lists, and visualizations
• 🔒 Secure Authentication - Powered by Supabase for robust user management
• 📈 Word Cloud Generation - Visual representation of frequently occurring words

---

🛠️ Tech Stack

🎨 Frontend (/site) Next.js 16 - React framework for production React - UI library Tailwind CSS - Utility-first styling Lucide React - Beautiful icon library Supabase - Authentication & database

⚡ Backend (/api) Bun - Fast all-in-one JavaScript runtime ElysiaJS - Ergonomic web framework Wink NLP - Natural language processing Swagger - API documentation

---

📊 API Response

The API provides comprehensive sentiment analysis results:

Field	Description
🎭 Sentiment	Classification: Positive, Negative, or Neutral
📈 Polarity Score	Range: -1 to 1 (< 0: negative, 0: neutral, > 0: positive)
✅ Positive Score	Total count of positive words
❌ Negative Score	Total count of negative words
💚 Positive Words	List of all detected positive words
💔 Negative Words	List of all detected negative words
❓ Unidentified Words	List of words not recognized by the model
🔑 Keywords	Most frequently occurring words
☁️ Word Cloud	Visual image of frequent words

---

🌍 Supported Languages

Language	Status
🇬🇧 English	✅ Supported
🇮🇳 Hindi	✅ Supported
🇮🇳 Marathi	✅ Supported
🇮🇳 Tamil	✅ Supported

---

📁 Project Structure

Senti-Vox/
├── api/
│   ├── src/
│   └── README.md
│
├── site/
│   ├── app/
│   ├── components/
│   ├── lib/
│   ├── network/
│   ├── public/
│   └── README.md
│
└── Images/

Directory	Description
/api	Backend API built with ElysiaJS and Bun - handles sentiment analysis and token management
/site	Full stack web app built with Next.js 16 and Supabase - provides UI for API interaction
/Images	Contains PNG and SVG Logos of Senti-Vox

---

🚀 Getting Started

Prerequisites

Ensure you have Bun installed: bun/releases.

Quick Start

1. Clone the repository

   git clone https://github.com/saksham-joshi/SentiVox.git
   cd Senti-Vox

2. Setup Backend

   cd api
   bun install
   bun run dev

   📚 Detailed instructions: API Setup Guide

3. Setup Frontend

   cd site
   bun install
   bun run dev

   📚 Detailed instructions: Site Setup Guide

4. Access the Application

   • Frontend: http://localhost:3000
   • API: http://localhost:8000

---

📖 Documentation

• 🔗 API Documentation - Interactive Swagger docs
• 📘 Setup Guides - Quick start instructions
• 🎯 Usage Examples - Code samples and tutorials

---

🤝 Contributors

👨‍💻 Saksham Joshi

👨‍💻 Subham Tiwari

---

📄 License

This project has no license. All rights reserved. Contact SAKSHAM JOSHI for permission to use.

Made with 💙 by Saksham Joshi & Subham Tiwari

Empowering multilingual sentiment analysis with speed and precision 🚀