PennGPT is an intelligent AI assistant specifically designed for the University of Pennsylvania community. Built with cutting-edge RAG (Retrieval-Augmented Generation) technology, it provides accurate, contextual information about Penn academics, student life, events, clubs, and campus resources.

• 🎯 Penn-Specific Knowledge: Comprehensive information about UPenn academics, clubs, events, and resources
• 💬 Natural Conversations: Chat-based interface with contextual understanding
• 🔍 Smart Search: Vector-powered semantic search across Penn's knowledge base
• 📱 Responsive Design: Modern, mobile-friendly React frontend
• 🔒 Secure & Fast: SSL-encrypted with optimized performance
• 📚 Citations: Provides sources for all information shared

graph TB
    A[👤 User] --> B[🌐 HTTPS Frontend<br/>penngpt.com]
    B --> C[🔄 Nginx Reverse Proxy]
    C --> D[⚛️ React SPA<br/>Vite + TypeScript]
    C --> E[🔌 API Proxy<br/>/api/*]
    E --> F[🐍 FastAPI Backend<br/>Python + Uvicorn]
    F --> G[🧠 Azure OpenAI<br/>GPT-4 + Embeddings]
    F --> H[📊 Milvus Vector DB<br/>Semantic Search]
    F --> I[📚 Knowledge Base<br/>Penn Data + Clubs]
    
    style A fill:#e1f5fe
    style B fill:#e8f5e8
    style G fill:#fff3e0
    style H fill:#f3e5f5
    style I fill:#e0f2f1

Frontend:

• ⚛️ React 18.3 with TypeScript
• ⚡ Vite for fast development and building
• 🎨 Tailwind CSS for modern styling
• 📱 Responsive Design with mobile-first approach
• 🔍 Zustand for state management

Backend:

• 🐍 Python FastAPI for high-performance APIs
• 🧠 Azure OpenAI (GPT-4, text-embedding-3-large)
• 📊 Milvus vector database for semantic search
• 🔄 Async/Await for concurrent processing
• 📚 RAG Pipeline for contextual responses

Infrastructure:

• 🔒 Nginx with SSL termination
• 📜 Let's Encrypt SSL certificates
• ☁️ AWS EC2 hosting
• 🌐 DNS with multiple domain support
• 🔄 Auto-renewal for certificates

Simply visit penngpt.com and start chatting! Ask about:

• 📚 Academics: Course information, requirements, schedules
• 🎭 Student Life: Clubs, organizations, events
• 🏛️ Campus Resources: Libraries, dining, facilities
• 📅 Events: Upcoming activities and deadlines
• ℹ️ General Info: Penn policies, contacts, directions

Base URL: https://penngpt.com/api/ or https://api.penngpt.velroi.com/

curl -X POST https://penngpt.com/api/chat \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Tell me about Penn clubs"}
    ],
    "top_k": 5
  }'

curl https://penngpt.com/api/health

Response Format:

{
  "answer": "Detailed response with Penn-specific information...",
  "citations": [
    {
      "title": "Source Title",
      "url": "https://example.com",
      "excerpt": "Relevant excerpt..."
    }
  ],
  "session_id": "unique-session-identifier"
}

cd frontend/frontend/client
npm install
npm run dev  # Development server on :5173
npm run build  # Production build

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Configure Azure OpenAI credentials

# Run development server
python -m uvicorn chat_assistant_api:app --reload --host 127.0.0.1 --port 8010

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=your_api_key_here
AZURE_OPENAI_ENDPOINT=your_endpoint_here
AZURE_OPENAI_API_VERSION=2024-12-01-preview
AZURE_OPENAI_MODEL=gpt-4
AZURE_OPENAI_EMBEDDING_MODEL=text-embedding-3-large

# Vector Database
MILVUS_DB_PATH=./milvus_lite.db
COLLECTION_NAME=web_documents

• 🛡️ SSL/TLS Encryption: All communications encrypted with Let's Encrypt certificates
• 🔐 Security Headers: HSTS, CSP, XSS protection, and more
• 🚫 CORS Protection: Properly configured cross-origin policies
• 🔄 Auto-Renewal: Certificates automatically renewed
• 📊 Rate Limiting: API endpoint protection
• 🔍 Input Validation: Secure request processing

• 🧠 Intelligent Responses: Context-aware answers using RAG architecture
• 📚 Comprehensive Knowledge: 1,399+ Penn clubs and extensive university data
• 🔍 Semantic Search: Vector-based similarity matching for relevant information
• 💬 Conversational Memory: Maintains context throughout chat sessions
• 📱 Mobile Optimized: Responsive design works on all devices
• ⚡ Fast Performance: Optimized for quick response times

• 🔄 Real-time Processing: Async backend for concurrent request handling
• 📈 Scalable Architecture: Designed to handle multiple users
• 🎨 Modern UI/UX: Clean, intuitive chat interface
• 🔗 Citation System: Provides sources for all information
• 📊 Vector Indexing: Efficient similarity search across knowledge base
• 🛠️ API-First Design: RESTful API for integration possibilities

We welcome contributions to make PennGPT even better!

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

Chat Endpoint:

• messages: Array of conversation messages
• top_k: Number of knowledge base results to retrieve (default: 5)
• session_id: Optional session identifier for conversation tracking

• 🌐 Website: penngpt.com
• 🔧 API: api.penngpt.velroi.com
• 📧 Contact: [email protected]
• 🐛 Issues: GitHub Issues