📋 Project Overview & Problem Statement
Challenge: Traditional astrology consultation requires expensive appointments with professional astrologers, and most digital horoscope services provide generic, impersonal readings that lack cultural context and depth.
Solution: The Professional Astrology Consultant (專業星座顧問) provides personalized, culturally-aware astrological guidance in Traditional Chinese, combining AI intelligence with traditional Chinese astrological wisdom to deliver professional-quality consultations accessible 24/7.
Key Benefits
- Cultural Authenticity: Deep understanding of Chinese astrological traditions and cultural context
- Personalized Insights: Tailored readings based on individual birth data and specific questions
- 24/7 Accessibility: Professional astrology consultation available anytime
- Cost-Effective: Eliminates expensive consultation fees while maintaining quality
- Privacy-Focused: Confidential consultations with no data retention
中文服务特色
- 传统智慧融合：结合中国传统占星学与现代AI技术
- 个性化咨询：根据出生时间、地点提供专属星座分析
- 文化理解：深度理解中华文化背景下的占星解读
- 专业水准：媲美专业占星师的咨询质量
🛠️ Technical Architecture & Implementation
Backend Architecture
Python 3.8+
Streamlit Framework
Claude API
Chinese NLP
Cultural AI
AI & Language Technologies
Anthropic Claude
Traditional Chinese
Cultural Context AI
Conversational AI
Personalization
Cultural & Domain Knowledge
Astrological Systems
Chinese Traditions
Cultural Sensitivity
Traditional Wisdom
System Architecture
Conversation Management:
- Intelligent conversation flow with context retention
- Cultural sensitivity filters and appropriate response generation
- Personalization based on user birth data and preferences
- Multi-turn dialogue support for complex consultations
Knowledge Integration:
- Comprehensive astrological database with cultural interpretations
- Chinese cultural calendar and traditional festival integration
- Professional astrology methodology implementation
- Personalized insight generation based on individual profiles
📖 Development Setup & Installation Guide
Prerequisites
- Python 3.8+ with pip package manager
- Claude API Key from Anthropic
- Chinese Language Support: UTF-8 encoding setup
- Development Environment: VS Code with Python and Chinese language support
Quick Start Installation
# Clone the repository
git clone https://github.com/lyven81/ai-project.git
cd ai-project/projects/horoscope-chatbot
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Set up environment variables
echo "CLAUDE_API_KEY=your_api_key_here" > .env
# Run the application
streamlit run app.py
Environment Configuration
# Required Configuration
CLAUDE_API_KEY=your_claude_api_key_here
# Optional Settings
DEFAULT_LANGUAGE=zh-TW
ENABLE_CULTURAL_MODE=true
DEBUG_MODE=false
MAX_CONVERSATION_LENGTH=20
Chinese Language Setup
- Encoding: Ensure UTF-8 encoding for Chinese character support
- Fonts: Install Chinese fonts for proper character rendering
- Input Method: Configure Chinese input methods for testing
- Locale: Set system locale for Chinese character processing
🚀 Deployment & Cultural Localization
Docker Deployment
# Build Docker image with Chinese support
docker build -t horoscope-chatbot .
# Run with environment variables
docker run -p 8501:8501 \
-e CLAUDE_API_KEY=your_api_key \
horoscope-chatbot
Google Cloud Run Deployment
# Deploy to Google Cloud with Chinese locale support
gcloud run deploy horoscope-chatbot \
--image gcr.io/PROJECT-ID/horoscope-chatbot \
--platform managed \
--region asia-southeast1 \
--set-env-vars CLAUDE_API_KEY=your_api_key,LANG=zh_TW.UTF-8
Cultural Localization Features
- Language Support: Full Traditional Chinese interface and responses
- Cultural Calendar: Integration with Chinese festivals and auspicious dates
- Regional Adaptation: Customized for different Chinese-speaking regions
- Cultural Values: Responses aligned with Chinese cultural values and traditions