Lucie-AI - GitLite

KO | EN

gitlite — search

#chatbot #golang #agent #css #tensorflow #graphql #ai-agent #devops #macos #chatgpt

Lucie-AI

(★ 33)

A real-time 2D Live AI companion powered by Groq (LLaMA 3.3 & Whisper) and Live2D Hiyori Pro.

파일 탐색기

ZIP 다운로드

- - ci.yml
- dependabot.yml
- __init__.py
- audio_utils.py
- config.py
- emotion_engine.py
- groq_client.py
- main.py
- memory.py
- requirements.txt
- tts_engine.py
- - style.css
- - audio-handler.js
  - emotion-animator.js
  - live2d-loader.js
  - main.js
  - ui-controller.js
  - websocket.js
- index.html
.env.example
.gitignore
build.sh
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
Procfile
README.md
SECURITY.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`uvicorn`

설명 보기 ▼

비동기 프로젝트를 위한 Python ASGI HTTP 서버.
더 많은 정보: <https://www.uvicorn.org/settings/>.

uvicorn {{import.path:app_object}}

Python 웹 앱 실행:

uvicorn --host {{localhost}} --port {{8080}} {{import.path:app_object}}

localhost에서 포트 8080으로 수신 대기:

uvicorn --reload {{import.path:app_object}}

라이브 리로드 활성화:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Lucie-AI is a next-generation AI companion that combines state-of-the-art Large Language Models (LLMs) with high-fidelity Live2D animation. It features a real-time, voice-driven interaction system with low-latency responses, expressive emotions, and dynamic physical gestures.

## 🌟 Key Features

- **Live2D Hiyori Pro Integration**: Fully rigged Cubism 4 model with idle motions, blinking, breathing, and head sway.
- **Emotion-Driven Expressivity**: AI-detected emotions (happy, sad, blush, etc.) trigger specific Live2D parameter changes and expressive gestures.
- **Voice-First Interaction**: Real-time audio recording and streaming with Groq Whisper STT and ultra-fast TTS fallback.
- **Intelligent Lip-Sync**: Real-time audio waveform analysis drives the Live2D model's mouth movements for natural speech synchronization.
- **Groq-Powered Intelligence**: Leverages LLaMA 3.3 70B for affectionate, context-aware conversations with persistent memory.
- **Production-Ready Backend**: FastAPI-based architecture with WebSocket support, optimized for deployment on Render.

## 🏗️ Architecture

```mermaid
graph TD
    A[User Browser] -- WebSocket --> B[FastAPI Backend]
    A -- Audio Stream --> B
    B -- Whisper STT --> C[Groq AI]
    C -- LLaMA 3.3 70B --> B
    B -- TTS Engine --> D[Voice Audio]
    B -- Live2D Params --> A
    D -- Audio Stream --> A
    A -- Lip-Sync Analysis --> E[Live2D Model]
```

## 🚀 Quick Start

### Prerequisites

- Python 3.11+
- [Groq API Key](https://console.groq.com/)
- Modern web browser with Microphone access

### Installation

1. **Clone the repository:**
   ```bash
   git clone https://github.com/vincenzo-afk/Lucie-AI.git
   cd Lucie-AI
   ```

2. **Set up the environment:**
   ```bash
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r backend/requirements.txt
   ```

3. **Configure Environment Variables:**
   Create a `.env` file in the root directory:
   ```env
   GROQ_API_KEY=your_groq_api_key_here
   PORT=8000
   ```

4. **Run the application:**
   ```bash
   python -m backend.main
   ```
   Open `http://localhost:8000` in your browser.

## 🛠️ Technical Stack

- **Frontend**: Vanilla ES Modules, PixiJS v8, Live2D Cubism 4 Core.
- **Backend**: FastAPI, Uvicorn, WebSockets.
- **AI/ML**: Groq Cloud (LLaMA 3.3 70B, Whisper-large-v3-turbo).
- **TTS**: edge-tts (Primary), gTTS (Fallback).
- **Deployment**: Render (Free/Starter Tier).

## 📂 Project Structure

- `/backend`: FastAPI application, AI clients, and TTS logic.
- `/frontend`: Web interface, Live2D assets, and animation engine.
- `/frontend/js`: Core animation and communication logic.
- `/frontend/model/Hiyori`: Hiyori Pro Live2D runtime assets.

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---
*Created by [vincenzo-afk](https://github.com/vincenzo-afk)*