🤖 OmniAssistant

AI-Powered Conversational Chatbot with Business Intelligence

An intelligent chatbot platform for pest control services featuring lead qualification, knowledge base retrieval, and comprehensive admin dashboard. Built with Next.js and Google Genkit for powerful AI conversations.

Live Demo · Report Bug · Request Feature

✨ Features

🎯 Core Features

AI-Powered Conversations: Intelligent chat using Google Gemini
Knowledge Base: Markdown-based knowledge retrieval
Lead Qualification: Smart form-based lead capture
Multi-Conversation: Handle multiple customer chats
Real-time Responses: Instant AI-generated replies
Context Awareness: Maintains conversation history

🔒 Admin Features

Comprehensive Dashboard: Full business overview
Conversation Management: View and manage all chats
Lead Management: Track and qualify potential customers
Order Tracking: Monitor service orders and status
Knowledge Base Editor: Manage FAQ and resources
Analytics: Insights into customer interactions

🎬 Demo

Chat Interface

Customers interact with an intelligent AI assistant that can:

Answer pest control questions from the knowledge base
Qualify leads through conversational forms
Provide service information and pricing
Schedule appointments and consultations

Admin Dashboard

Business owners get access to:

Overview Page: Key metrics and recent activity
Conversations: All customer chat histories
Leads: Qualified prospects with contact information
Orders: Service requests and their status
Knowledge Base: Content management for FAQ

🏗️ Architecture

graph TB
    A[Customer Chat UI] -->|User Message| B[Next.js API Routes]
    B -->|AI Request| C[Genkit AI Flows]
    C -->|Query| D[Knowledge Base - Markdown]
    C -->|Generate| E[Google Gemini AI]
    E -->|Response| B
    B -->|Display| A
    F[Admin Dashboard] -->|Manage| G[Mock Data Store]
    C -->|Store| G

Key Components

Frontend (Next.js + React)

Server-side rendering for optimal performance
Beautiful UI with shadcn/ui components
Responsive design for all devices
Real-time chat interface

AI Layer (Genkit)

Conversation flow management
Knowledge base retrieval with embeddings
Lead qualification logic
Integration with Google Gemini

Backend (Next.js API Routes)

RESTful API endpoints
Server actions for mutations
Mock data storage (easily replaceable with DB)

🛠 Tech Stack

Frontend

AI & Backend

UI Components

🚀 Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

Node.js 20+ (Download)
npm or yarn
Google AI API Key (Get Key - Free tier available)

Installation

Clone the repository

git clone https://github.com/mu7ammad-3li/OmniAssistant.git
cd OmniAssistant

Install dependencies

npm install

Configuration

Create environment file

Create a .env.local file in the root directory:

# Google AI (Gemini) Configuration
GOOGLE_GENAI_API_KEY=your-google-ai-api-key-here

# Application Configuration
NEXT_PUBLIC_APP_NAME=OmniAssistant
NEXT_PUBLIC_APP_URL=http://localhost:9002

# Optional: Development Settings
NODE_ENV=development

Getting Google AI API Key:

Visit Google AI Studio
Sign in with your Google account
Click "Get API Key"
Create a new API key
Copy the key to your .env.local file
Run the development server

Option 1: Next.js only

npm run dev

Option 2: Next.js + Genkit Dev UI

In separate terminals:

# Terminal 1: Next.js dev server
npm run dev

# Terminal 2: Genkit development UI (for AI flow testing)
npm run genkit:dev

The application will be running at:

Next.js App: http://localhost:9002
Genkit Dev UI: http://localhost:4000 (if running genkit:dev)

Build for production

npm run build
npm run start

📁 Project Structure

OmniAssistant/
├── 📂 src/                          # Source code
│   ├── 📂 app/                      # Next.js app directory
│   │   ├── 📂 admin/               # Admin dashboard
│   │   │   ├── 📂 conversations/  # Conversation management
│   │   │   ├── 📂 leads/          # Lead management
│   │   │   ├── 📂 orders/         # Order management
│   │   │   ├── 📂 kb/             # Knowledge base editor
│   │   │   ├── layout.tsx         # Admin layout
│   │   │   └── page.tsx           # Dashboard overview
│   │   ├── 📂 api/                 # API routes
│   │   │   └── 📂 genkit/         # Genkit API endpoints
│   │   ├── 📂 chat/                # Customer chat interface
│   │   │   └── page.tsx           # Chat page
│   │   ├── layout.tsx              # Root layout
│   │   ├── page.tsx                # Home page
│   │   └── globals.css             # Global styles
│   ├── 📂 ai/                       # Genkit AI flows
│   │   ├── conversation-flow.ts    # Main conversation AI
│   │   ├── lead-qualification.ts   # Lead capture flow
│   │   ├── knowledge-retrieval.ts  # KB search flow
│   │   ├── dev.ts                  # Genkit dev server
│   │   └── index.ts                # AI exports
│   ├── 📂 components/               # React components
│   │   ├── 📂 ui/                  # shadcn/ui components
│   │   │   ├── button.tsx
│   │   │   ├── card.tsx
│   │   │   ├── dialog.tsx
│   │   │   └── ...
│   │   ├── 📂 chat/                # Chat components
│   │   │   ├── ChatMessage.tsx
│   │   │   ├── ChatInput.tsx
│   │   │   └── ChatInterface.tsx
│   │   ├── 📂 admin/               # Admin components
│   │   │   ├── Sidebar.tsx
│   │   │   ├── StatCard.tsx
│   │   │   └── DataTable.tsx
│   │   └── 📂 forms/               # Form components
│   │       └── LeadQualificationForm.tsx
│   ├── 📂 hooks/                    # Custom React hooks
│   │   ├── useChat.ts
│   │   └── useConversations.ts
│   ├── 📂 kb/                       # Knowledge base (Markdown)
│   │   ├── pest-identification.md
│   │   ├── treatment-methods.md
│   │   ├── prevention-tips.md
│   │   └── pricing-info.md
│   ├── 📂 lib/                      # Utilities
│   │   ├── mock-data.ts            # Mock data store
│   │   └── utils.ts                # Helper functions
│   └── 📂 types/                    # TypeScript types
│       ├── conversation.ts
│       ├── lead.ts
│       └── order.ts
├── 📂 public/                       # Static assets
├── .env.local                       # Environment variables (create this)
├── .env.example                     # Environment template
├── .gitignore                       # Git ignore rules
├── next.config.js                   # Next.js configuration
├── package.json                     # Dependencies and scripts
├── tailwind.config.ts               # Tailwind configuration
├── tsconfig.json                    # TypeScript configuration
└── README.md                        # This file

🤖 AI Flows

OmniAssistant uses Google Genkit to power three main AI flows:

1. Conversation Flow (`conversation-flow.ts`)

Handles general customer conversations:

Understands pest control questions
Retrieves relevant information from knowledge base
Maintains conversation context
Provides helpful, natural responses

2. Lead Qualification (`lead-qualification.ts`)

Intelligently qualifies potential customers:

Asks relevant qualifying questions
Captures contact information
Assesses urgency and service needs
Stores lead data for follow-up

3. Knowledge Retrieval (`knowledge-retrieval.ts`)

Searches the knowledge base:

Converts Markdown files to embeddings
Performs semantic search
Returns relevant content chunks
Integrates with conversation flow

Testing AI Flows

Use the Genkit Dev UI to test AI flows in isolation:

npm run genkit:dev

Visit http://localhost:4000 to interact with individual flows.

📊 Admin Dashboard

The admin dashboard provides complete business management:

Dashboard Overview

Total Conversations: Count of customer chats
Active Leads: Qualified prospects
Pending Orders: Service requests awaiting action
Recent Activity: Latest conversations and leads

Conversations Page

View all customer conversations
Search and filter by customer or date
See full conversation history
Mark conversations as resolved

Leads Page

Manage qualified leads
Contact information and needs
Lead source and qualification status
Export leads as CSV

Orders Page

Track service orders
Update order status
View customer details
Manage fulfillment

Knowledge Base

Edit Markdown knowledge base files
Add new FAQ entries
Organize content by category
Preview changes

📜 Available Scripts

# Development server (Next.js only)
npm run dev

# Genkit AI flow development UI
npm run genkit:dev

# Genkit with auto-reload (watch mode)
npm run genkit:watch

# Build for production
npm run build

# Start production server
npm run start

# Lint code
npm run lint

# Type check
npm run typecheck

🌐 Deployment

Deploy to Vercel (Recommended)

Install Vercel CLI

npm install -g vercel

Set environment variables in Vercel dashboard

GOOGLE_GENAI_API_KEY=your-api-key

Deploy

vercel

Deploy to Other Platforms

Netlify:

npm run build
# Deploy the .next folder

Docker:

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
CMD ["npm", "start"]

🔄 Replacing Mock Data

The project currently uses mock data for demonstration. To integrate with a real database:

Choose a database (PostgreSQL, MongoDB, Firebase, etc.)
Install database client

npm install prisma @prisma/client  # Example for Prisma

Replace mock functions in src/lib/mock-data.ts
Update API routes to use real database queries
Add authentication for admin dashboard

🤝 Contributing

Contributions are what make the open-source community amazing! Any contributions you make are greatly appreciated.

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

Distributed under the MIT License. See LICENSE for more information.

📧 Contact

Muhammad Ali

Project Link: https://github.com/mu7ammad-3li/OmniAssistant

🙏 Acknowledgments

Next.js - React framework
Google Genkit - AI orchestration framework
Google Gemini - Large language model
shadcn/ui - UI components
Tailwind CSS - Styling
Radix UI - Headless UI components

Built with ❤️ by Muhammad Ali

Intelligent Conversations, Powered by AI

⬆ Back to Top

Name		Name	Last commit message	Last commit date
Latest commit History 20 Commits
.idx		.idx
docs		docs
src		src
.gitignore		.gitignore
.modified		.modified
README.md		README.md
apphosting.yaml		apphosting.yaml
components.json		components.json
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation