Skip to content

dwivedidayashankar31-art/nexus-ai

Repository files navigation

Nexus AI

🤖 Nexus AI

Autonomous Customer Resolution Platform

Resolve customer queries in seconds — via Voice or Text — 24/7, powered by OpenAI GPT-4o


Live Demo Portfolio GitHub


TypeScript React Node.js PostgreSQL OpenAI TailwindCSS License


📌 Table of Contents


🧠 What is Nexus AI?

Nexus AI is a production-ready, full-stack SaaS platform that uses OpenAI GPT-4o Audio to autonomously handle customer support queries — through both voice and text — without any human agent.

It cuts customer support response time from 30 minutes → 3 seconds, reduces support costs by 80%, and stays available 24 hours a day, 7 days a week.

Built for startups, e-commerce companies, fintech, healthcare, and any business that needs scalable, intelligent customer support.


✨ Key Features

🎙️ AI Voice & Text Support

  • Real-time voice conversations using OpenAI GPT-4o Audio Realtime API
  • Text chat with streaming responses (word-by-word, like ChatGPT)
  • Smart quick-action suggestions (Refund, Password Reset, Escalate, Update Account)
  • Conversation history with timestamps

🤖 Autonomous AI Actions

The AI agent can independently perform:

  • Issue refunds — process customer refund requests
  • Reset passwords — handle login/account recovery
  • Cancel orders — manage order cancellations
  • Escalate tickets — route complex issues to human agents
  • Update account info — modify customer details

📊 CRM Dashboard (Protected Route)

  • Live statistics: Customers, Open Tickets, Escalations, Resolved Cases
  • Customer directory with full profile view
  • Ticket management and status tracking
  • Agent action log — every AI action recorded
  • Fully protected — requires authenticated session

🔐 Secure Authentication

  • Session-based auth with Passport.js LocalStrategy
  • Passwords hashed with bcryptjs (12 salt rounds)
  • 7-day persistent sessions via connect-pg-simple
  • Real-time form validation:
    • Username: 3–20 chars, alphanumeric only
    • Password: min 6 chars, at least 1 letter + 1 number
  • Show/hide password toggle
  • English-only error messages

⚙️ Fully Functional Settings Panel

Section Options
Account View profile, role, session status, change password
Appearance Dark / Light / System theme (persisted)
Language English, Hindi, Spanish, French
Notifications Email alerts, AI action alerts, escalation alerts
AI Preferences Voice mode, auto-log, streaming, response style
About Platform info, version, tech stack
Contact Us Clickable phone & email

All settings are persisted to localStorage — survive page reloads.

💳 Pricing & Plans

  • 3-tier pricing: Starter / Professional / Enterprise
  • Razorpay payment integration (ready to activate)
  • Clean pricing cards with feature comparison

🌐 Portfolio Page

  • Beautiful standalone marketing page at /portfolio
  • Animated hero section, stats counter, feature cards
  • Tech stack grid, how-it-works steps, pricing preview
  • Clickable contact links (phone + email)

🚀 Live Demo

Page Link
🏠 AI Support (Home) nexus-ai.replit.app
🌐 Portfolio nexus-ai.replit.app/portfolio
📊 CRM Dashboard nexus-ai.replit.app/crm (login required)
💳 Pricing nexus-ai.replit.app/pricing
⚙️ Settings nexus-ai.replit.app/settings

📸 Screenshots

🤖 AI Support — Voice & Text Agent

Real-time AI conversations with streaming responses, voice recording, and quick action suggestions.

📊 CRM Dashboard

Live analytics with customer directory, ticket management, and agent action log. Protected by authentication.

⚙️ Settings Panel

Functional settings with theme switching (Dark/Light/System), language preferences, notifications, AI preferences, and Contact Us section.

🌐 Portfolio Page

Beautiful marketing page showcasing the platform with animated stats, feature cards, and pricing.


🛠️ Tech Stack

Frontend

Technology Version Purpose
React 18 UI framework
TypeScript 5 Type safety
Tailwind CSS 3 Styling
Framer Motion Latest Animations
TanStack Query v5 Server state management
Wouter Latest Client-side routing
shadcn/ui Latest UI components
Lucide React Latest Icons

Backend

Technology Version Purpose
Node.js 20+ Runtime
Express.js 4 HTTP server
TypeScript 5 Type safety
Drizzle ORM Latest Database ORM
PostgreSQL 14+ Database
Passport.js Latest Authentication
bcryptjs Latest Password hashing
express-session Latest Session management
connect-pg-simple Latest PostgreSQL session store

AI & Integrations

Technology Purpose
OpenAI GPT-4o Audio Voice + text AI responses
Server-Sent Events (SSE) Real-time streaming
Razorpay Payment processing (integration ready)

📁 Project Structure

nexus-ai/
│
├── client/                          # React Frontend
│   └── src/
│       ├── pages/
│       │   ├── customer-support.tsx # AI Support Agent (Home)
│       │   ├── crm-portal.tsx       # CRM Dashboard (Protected)
│       │   ├── payment.tsx          # Pricing & Plans
│       │   ├── settings.tsx         # Settings Panel
│       │   ├── portfolio.tsx        # Marketing Portfolio Page
│       │   └── login.tsx            # Login / Register
│       │
│       ├── components/
│       │   ├── layout.tsx           # Sidebar navigation layout
│       │   ├── waveform.tsx         # Audio waveform visualizer
│       │   └── ui/                  # shadcn/ui components
│       │
│       ├── hooks/
│       │   ├── use-auth.ts          # Authentication hooks
│       │   ├── use-settings.tsx     # Settings context + persistence
│       │   ├── use-crm.ts           # CRM data hooks
│       │   └── use-voice.ts         # Voice/conversation hooks
│       │
│       └── lib/
│           └── queryClient.ts       # TanStack Query setup
│
├── server/                          # Express Backend
│   ├── index.ts                     # Entry point
│   ├── auth.ts                      # Passport.js auth + all auth APIs
│   ├── routes.ts                    # CRM & AI API routes
│   ├── storage.ts                   # Database interface (Drizzle)
│   ├── db.ts                        # PostgreSQL connection
│   └── replit_integrations/         # OpenAI Audio integration
│
├── shared/
│   └── schema.ts                    # Drizzle schema + Zod types
│
├── replit.md                        # Project documentation
└── README.md                        # This file

🚀 Getting Started

Prerequisites

  • Node.js 20 or higher
  • PostgreSQL 14+ database
  • OpenAI API key (with Realtime Audio access)

1. Clone the Repository

git clone https://github.com/dwivedidayashankar31-art/nexus-ai.git
cd nexus-ai

2. Install Dependencies

npm install

3. Set Up Environment Variables

Create a .env file in the root directory:

DATABASE_URL=postgresql://username:password@localhost:5432/nexusai
SESSION_SECRET=your-super-secret-session-key-here
OPENAI_API_KEY=sk-your-openai-api-key-here

4. Set Up Database

npm run db:push

5. Start Development Server

npm run dev

The app will be available at http://localhost:5000

Note: Frontend and backend both run on port 5000 — Vite proxies API requests automatically.


🔐 Environment Variables

Variable Required Description
DATABASE_URL ✅ Yes PostgreSQL connection string
SESSION_SECRET ✅ Yes Secret for session encryption (use a long random string)
OPENAI_API_KEY ✅ Yes OpenAI API key with GPT-4o Audio access
NODE_ENV Optional development or production (default: development)

📡 API Reference

Authentication

Method Endpoint Auth Required Description
POST /api/register Create new user account
POST /api/login Sign in with credentials
POST /api/logout End current session
GET /api/me Get current authenticated user
POST /api/change-password Update account password

AI & Conversations

Method Endpoint Auth Required Description
GET /api/conversations List all conversations
POST /api/conversations Create new conversation
GET /api/conversations/:id Get specific conversation

CRM

Method Endpoint Auth Required Description
GET /api/stats Get dashboard statistics
GET /api/customers List all customers
GET /api/customers/:id Get customer profile
GET /api/tickets List all support tickets
POST /api/tickets Create new ticket
GET /api/actions Get AI agent action log

Register Request Body

{
  "username": "john123",
  "password": "john@123"
}

Validation Rules

  • Username: 3–20 characters, letters and numbers only
  • Password: Min 6 characters, at least 1 letter + 1 number

💳 Pricing Plans

Plan Price Conversations Features
Starter ₹2,999/month 500/month AI Text, Basic CRM, Email support
Professional ₹7,999/month 2,000/month AI Voice + Text, Full CRM, Priority support, Custom branding
Enterprise Custom Unlimited Dedicated AI agent, White-label, 24/7 support, Custom integrations

💡 Free 14-day trial available. No credit card required.


📈 Why Nexus AI?

Metric Without Nexus AI With Nexus AI
Response Time 30+ minutes Under 3 seconds
Support Cost ₹50,000+/month (agents) ₹2,999/month
Availability 9 AM – 6 PM 24/7/365
Simultaneous Users 1 per agent 1,000+
Consistency Varies by agent Always professional
Scalability Hire more staff Instant scale

👨‍💻 About the Developer

Dayashankar Dwivedi — Full-Stack Developer & AI Enthusiast

Built Nexus AI as a complete, production-ready SaaS platform demonstrating:

  • Real-time AI voice integration (OpenAI Realtime API)
  • Secure session-based authentication
  • Full-stack TypeScript development
  • PostgreSQL database design with Drizzle ORM
  • Professional dark-themed UI with Tailwind + Framer Motion

📞 Contact

📱 Phone / WhatsApp +91 74896 55562
📧 Email dwivedidayashankar31@gmail.com
🐙 GitHub github.com/dwivedidayashankar31-art

💼 Available for freelance projects, custom enterprise deployments, and collaboration.


📄 License

This project is licensed under the MIT License — feel free to use, modify, and distribute.

MIT License — Copyright (c) 2025 Dayashankar Dwivedi

⭐ If you found this project useful, please give it a star on GitHub!


Live Demo Portfolio Contact


Built with ❤️ by Dayashankar Dwivedi

About

Nexus AI — Autonomous Customer Resolution Platform with voice/text AI, CRM portal, and user authentication

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors