Skip to content

KushalPraja/persona

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

31 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Persona - AI Agent Knowledge Base Platform

Introducing.Persona.-.Helpful.Product.Agents.mp4

Transform your business operations with intelligent AI agents that serve as dynamic knowledge bases. Scale operations 24/7 with autonomous agents that instantly access company data, answer questions, and automate workflows.

Features

AI Agent Automation

  • Intelligent Knowledge Bases: Deploy AI agents that serve as dynamic repositories of business intelligence
  • 24/7 Operations: Continuous automation and knowledge access
  • Instant Data Access: Real-time retrieval of company information and insights
  • Workflow Automation: Knowledge-driven process automation

Visual Product Modeling

  • Interactive Flow Builder: Create connected knowledge bases with visual node-based interface
  • Flexible Component System: Overview, Features, Use Cases, Personas, Capabilities, Limitations, and Media nodes
  • Custom Fields: Add arbitrary key-value pairs for specific business needs
  • CSV Export: Export structured data for external use

Modern UI/UX

  • Responsive Design: Mobile-first approach with adaptive layouts
  • Clean Interface: Modern, professional design with intuitive navigation
  • Real-time Chat: Interactive AI-powered chat interface with graph visualizations

๐Ÿ› ๏ธ Tech Stack

Frontend

  • Next.js 14: React framework with App Router
  • TypeScript: Type-safe development
  • Tailwind CSS: Utility-first CSS framework
  • Framer Motion: Smooth animations and transitions
  • React Flow: Interactive node-based UI components
  • Shadcn/ui: Modern component library

Backend

  • Node.js: Server runtime
  • Express.js: Web application framework
  • Google Gemini AI: Advanced language model integration
  • RESTful APIs: Clean API architecture

Database & Infrastructure

  • MongoDB: NoSQL database for flexible data storage
  • Supabase: Authentication and real-time features
  • Docker: Containerized development and deployment
  • Local Storage: Client-side data persistence
  • SVG Graphics: Scalable vector graphics for branding

Project Structure

persona/
โ”œโ”€โ”€ client/                 # Next.js frontend application
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ app/           # App Router pages
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ page.tsx                    # Landing page
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ (dashboard)/home/           # Dashboard
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ product/[id]/               # Product flow builder
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ bot/[id]/                   # Chat interface
โ”‚   โ”‚   โ”œโ”€โ”€ components/    # Reusable UI components
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ ui/        # Shadcn/ui components
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ app-sidebar.tsx             # Main navigation
โ”‚   โ”‚   โ””โ”€โ”€ lib/           # Utilities and helpers
โ”‚   โ”œโ”€โ”€ public/            # Static assets
โ”‚   โ”‚   โ”œโ”€โ”€ logo.svg       # Main logo
โ”‚   โ”‚   โ”œโ”€โ”€ favicon.svg    # Browser favicon
โ”‚   โ”‚   โ””โ”€โ”€ icon-192.svg   # High-res app icon
โ”‚   โ”œโ”€โ”€ Dockerfile         # Frontend container configuration
โ”‚   โ””โ”€โ”€ package.json       # Frontend dependencies
โ”œโ”€โ”€ server/                # Node.js backend
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ index.js       # Main server file
โ”‚   โ”‚   โ”œโ”€โ”€ db.js          # MongoDB connection
โ”‚   โ”‚   โ””โ”€โ”€ services/      # Business logic
โ”‚   โ”œโ”€โ”€ Dockerfile         # Backend container configuration
โ”‚   โ””โ”€โ”€ package.json       # Backend dependencies
โ”œโ”€โ”€ docker-compose.yml     # Multi-container orchestration
โ””โ”€โ”€ README.md             # Project documentation

๐Ÿšฆ Getting Started

Prerequisites

  • Node.js 18+
  • Docker and Docker Compose
  • MongoDB (or use Docker container)
  • npm or pnpm package manager

Installation

  1. Clone the repository

    git clone <repository-url>
    cd persona
  2. Start with Docker (Recommended)

    # Start all services (MongoDB, backend, frontend)
    docker-compose up -d
  3. Or install manually

    Install frontend dependencies:

    cd client
    npm install
    # or
    pnpm install

    Install backend dependencies:

    cd ../server
    npm install
  4. Set up environment variables

    cd ../client
    cp .env.local.example .env.local

    Edit .env.local with your configuration:

    NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
    NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
    GEMINI_API_KEY=your_gemini_api_key
    MONGODB_URI=mongodb://localhost:27017/persona
  5. Start the development servers (if not using Docker)

    Start MongoDB:

    # Option 1: Use Docker
    docker run -d -p 27017:27017 --name persona-mongo mongo:latest
    
    # Option 2: Use local MongoDB installation
    mongod

    Backend (Terminal 1):

    cd server
    npm start

    Frontend (Terminal 2):

    cd client
    npm run dev
  6. Open your browser

    http://localhost:3000
    

๐ŸŽฏ Usage

Creating AI Knowledge Bases

  1. Start a New Project

    • Navigate to the dashboard
    • Choose a quick start template or create custom
    • Define your product name and documentation tone
  2. Build Your Knowledge Structure

    • Use the visual flow builder to create connected nodes
    • Add Overview, Features, Use Cases, Personas, and more
    • Connect nodes to show relationships
    • Add custom fields for specific business data
  3. Deploy Your AI Agent

    • Publish your knowledge base
    • Generate an AI chat interface
    • Share with your team or customers

Chat Interface Features

  • Multi-view Navigation: Switch between Chat, Graph, and FAQ views
  • 3D Graph Visualization: Interactive exploration of knowledge connections
  • Mobile-Responsive: Optimized for all device sizes
  • QR Code Sharing: Easy sharing across devices

๐Ÿ”ง Configuration

Tone Options

  • Professional: Clear, formal, business-focused
  • Friendly: Warm, approachable, conversational
  • Technical: Detailed, precise, expert-level
  • Casual: Relaxed, informal, easy-going
  • Authoritative: Confident, decisive, commanding
  • Empathetic: Understanding, supportive, caring

Component Types

  • Overview: Core product information
  • Features: Key functionality and capabilities
  • Use Cases: Real-world applications and scenarios
  • Personas: Target user profiles and segments
  • Capabilities: What the product can accomplish
  • Limitations: Known constraints and boundaries
  • Media: Images, videos, and visual content
  • Custom Fields: Flexible key-value data

๐ŸŽจ Branding

The Persona brand uses a modern, organized design system:

  • Logo: Multi-colored component grid representing organized knowledge
  • Colors: Professional dark theme with colorful accents
  • Typography: Clean, readable fonts with proper hierarchy
  • Icons: Consistent iconography throughout the interface

๐Ÿค Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

๐Ÿ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ†˜ Support

For support, please:

  • Check the documentation
  • Open an issue on GitHub
  • Contact the development team

๐Ÿ”ฎ Roadmap

  • Advanced AI model customization
  • Multi-language support
  • Advanced analytics and insights
  • Team collaboration features
  • API integrations
  • Enterprise security features
  • Kubernetes deployment support
  • Advanced MongoDB indexing and optimization
  • Supabase real-time collaboration features

๐Ÿณ Docker Support

The project includes full Docker support for easy development and deployment:

Development with Docker

# Start all services
docker-compose up -d

# View logs
docker-compose logs -f

# Stop all services
docker-compose down

# Rebuild containers
docker-compose build --no-cache

Production Deployment

# Build production images
docker-compose -f docker-compose.prod.yml build

# Deploy to production
docker-compose -f docker-compose.prod.yml up -d

Powered by Persona - Scale Your Business with AI Agent Automation

About

Tool for building AI-powered Q&A product support agents with one-click deployment.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors