🏯 ParadoxAI

Understand China Beyond Language

AI Expert for Chinese History and Culture

ParadoxAI is a multilingual AI assistant specialized exclusively in Chinese history and culture. It helps international users understand Chinese civilization without language barriers.

✨ Product Philosophy

• Open. Ask. Learn.
• No Login. No Complexity. Just Conversation.
• Friendly, simple, beginner-friendly, accessible to everyone

Users open the application and immediately start learning about China — no registration or complicated settings.

🎯 Core Features

Feature	Description
💬 Smart Chat	Ask anything about Chinese history, dynasties, culture, traditions
🌍 Auto Language	Detects your country, suggests your native language
🔍 Fact Checking	Verify historical claims in videos, articles, and images
🏯 Ancient Images	Generate scenes of ancient China, dynasties, historical figures
🎤 Voice Explanations	Listen to answers in Bangla, English, Hindi, Japanese, and more
📱 Recommendations	Find content from Douyin, Xiaohongshu, Bilibili

🧠 AI Workflow

User Question
    ↓
  AI Router
    ↓
┌─────────────────────────┐
│  Qwen    DeepSeek  HunYuan  │  ← All 3 models queried in parallel
└─────────────────────────┘
    ↓
  Combine Results
    ↓
  Translate to User's Language
    ↓
  Text Response + Voice Response

🚀 Quick Start

Prerequisites

• Node.js ≥ 18
• Python ≥ 3.10

Backend

cd backend
python -m venv venv
venv\Scripts\activate     # Windows
pip install -r requirements.txt
python manage.py runserver

Frontend

cd frontend
npm install
npm run dev

Frontend: http://localhost:3000 | Backend API: http://localhost:8000

🏗️ Project Structure

paradoxai/
├── frontend/                    # Vue 3 + Vite
│   ├── src/
│   │   ├── components/          # Sidebar, ChatInput, ChatMessage, VoicePlayer
│   │   ├── pages/               # Chat (onboarding), FactChecker, ImageGenerator, Settings
│   │   ├── router/              # Vue Router
│   │   ├── services/            # API service layer
│   │   ├── stores/              # Pinia state (session, language)
│   │   └── assets/styles/       # Global CSS (Chinese theme)
│   └── package.json
│
├── backend/                     # Django + DRF (NO database)
│   ├── chat/                    # Chat API + Onboarding
│   ├── services/
│   │   ├── ai_models/           # Qwen, DeepSeek, Hunyuan + AI Router
│   │   ├── translator/          # Language detection + country→language mapping
│   │   ├── fact_checker/        # Chinese history fact verification
│   │   ├── image_generator/     # Ancient China image generation
│   │   ├── voice/               # Multi-language TTS
│   │   ├── recommendations/     # Douyin, RedNote, Bilibili
│   │   └── prompts/             # System prompts (Chinese history focus)
│   ├── session/                 # In-memory session (no database)
│   ├── utils/                   # Helpers, constants, formatters
│   └── .env
│
└── README.md

🌍 Supported Languages

Bangla, English, Hindi, Arabic, Indonesian, Japanese, Korean, Chinese, French, German, Spanish, Portuguese, Russian, Turkish, Thai, Vietnamese, Urdu, Swahili, Hausa, Amharic, and more.

📄 Tech Stack

Frontend: Vue 3 · Vite · Vue Router · Pinia · Axios · Marked

Backend: Django · Django REST Framework · OpenAI SDK

AI Models: Qwen (通义千问) · DeepSeek · HunYuan (混元)

No Database — in-memory sessions only. No user data stored.