Kira.AI

Kira.AI is a sophisticated AI-powered chat application featuring advanced voice interaction, real-time 3D visualizations, and seamless integration with the Groq and Deepgram APIs.

📸 Screenshot

🚀 Features

• Groq LLM: Ultra-fast intelligence powered by Llama 3 models on Groq.
• Deepgram TTS: High-fidelity, low-latency AI voice integration with streaming support.
• Voice Interaction: Integrated speech recognition for hands-free communication.
• 3D Particle Sphere: Interactive 3D visualization using Three.js that responds dynamically to voice and audio output.
• Responsive UI: Sleek, modern design built with React, CSS, and Tailwind.

📁 File Structure

Kira.AI/
├── .github/              # GitHub Actions workflows for CI/CD
├── aws/                   # AWS deployment configurations
├── public/                # Static assets
├── src/
│   ├── components/        # React components
│   │   ├── ChatContainer.tsx    # Main chat interface
│   │   ├── ChatMessage.tsx      # Individual chat bubbles
│   │   ├── Header.tsx           # Application header
│   │   ├── ParticleSphere.tsx   # Three.js 3D visualization
│   │   └── VoiceButton.tsx      # Integrated voice control
│   ├── hooks/             # Custom React hooks
│   │   ├── useAudioAnalyzer.ts  # Audio processing for 3D visualizer
│   │   ├── useDeepgramTTS.ts    # Deepgram Text-to-Speech integration
│   │   ├── useGroq.ts           # Groq LLM integration logic
│   │   ├── useSpeechRecognition.ts # Browser speech recognition
│   │   └── useSpeechSynthesis.ts   # Web Speech API fallback
│   ├── types/             # TypeScript type definitions
│   ├── App.tsx            # Main application component
│   ├── index.css          # Global styles
│   └── main.tsx           # Entry point
├── Dockerfile             # Docker configuration for deployment
├── docker-compose.yml     # Multi-container orchestration
├── nginx.conf             # Web server configuration
├── package.json           # Dependencies and scripts
├── tsconfig.json          # TypeScript configuration
└── vite.config.ts         # Vite build tool setup

🛠️ Technology Stack

• Frontend: React, TypeScript
• Styling: Tailwind CSS
• 3D Graphics: Three.js, @react-three/fiber
• AI Integration:
  • Groq API (LLM - Llama 3)
  • Deepgram API (TTS - Aura)
• Deployment: Docker, AWS (Nginx), GitHub Actions

🚦 Getting Started

Prerequisites

• Node.js (v18+)
• npm or yarn

Installation

1. Clone the repository:

   git clone https://github.com/ankurraj007/kira.AI.git

2. Install dependencies:

   npm install

3. Create a .env file and add your API Keys:

   VITE_GROQ_API_KEY=your_groq_api_key_here
   VITE_DEEPGRAM_API_KEY=your_deepgram_api_key_here

4. Start the development server:

   npm run dev

📄 License

This project is licensed under the MIT License.

---