title: Lichtblick German Assistant
emoji: 🚀
colorFrom: red
colorTo: red
sdk: docker
app_port: 8501
tags:
- streamlit
pinned: false
short_description: Lichtblick helps you learn German—word by word
license: apache-2.0
thumbnail: >-
https://cdn-uploads.huggingface.co/production/uploads/60ef4a57fe56ad3fb7a22ce0/BXN_GpytquWBBzwvSGxoD.png
Lichtblick German Learning Assistant 🇩🇪📚💡
An AI-powered German language learning assistant that provides intelligent sentence analysis, vocabulary extraction, and grammatical explanations. Built with Streamlit and OpenAI's language models using an agents-as-tools architecture.
🚀 Live Demo
Try the app: lichtblick-german-assistant
✨ Features
- Intelligent Sentence Analysis: Get detailed word-by-word breakdowns with grammatical explanations
- Vocabulary Extraction: Extract German words with accurate English translations
- Smart Agent Routing: Automatically determines the best analysis approach for your input
- Interactive Chat Interface: Streamlit-powered conversational learning experience
🛠️ Technology Stack
- Backend: Python, OpenAI Agents SDK, OpenAI API
- Frontend: Streamlit
- AI Architecture: Multi-agent system built with OpenAI Agents SDK
- Deployment: Hugging Face Spaces
🏃♂️ Quick Start
Prerequisites
Python 3.12.10 (CPython)
pip
Installation
- Clone the repository:
git clone https://github.com/Ashish-Soni08/Lichtblick.git
cd Lichtblick
- Install dependencies:
pip install -r requirements.txt
Configure API Key: Enter your OpenAI API key in the app's sidebar when it loads
Run the application:
streamlit run app.py
- Open your browser and navigate to
http://localhost:8501
For Hugging Face Spaces: Simply visit the live demo link above - no local setup required!
📋 Usage
Getting Started
- Enter API Key: Add your OpenAI API key in the sidebar
- Ask Questions: Type German words, phrases, or sentences in the chat
- Get Analysis: Receive intelligent breakdowns and explanations
Learning Modes
Vocabulary Extraction
Perfect for single words or short phrases:
Input: "der Hund"
Output:
der (->) the
Hund (->) dog
Sentence Analysis
Detailed grammatical breakdown for full sentences:
Input: "Die Katze liegt auf dem Sofa."
Output:
The cat is lying on the sofa.
Die (->) the (feminine nominative singular definite article)
Katze (->) cat (feminine noun, nominative case)
liegt (->) is lying (third-person singular present tense of "liegen")
auf (->) on (preposition taking the dative case)
dem (->) the (masculine/neuter dative singular definite article)
Sofa (->) sofa (neuter noun, dative case)
Example Interactions
Vocabulary Help:
- "What does 'gemütlich' mean?"
- "Translate 'Bahnhof'"
Sentence Analysis:
- "Analyze this: 'Ich gehe zur Schule.'"
- "Break down: 'Der Mann liest ein Buch.'"
🧠 AI Architecture
This app uses a multi-agent system with specialized capabilities:
- Lichtblick Agent: Main coordinator that routes requests to specialized agents
- Vocabulary Agent: Extracts German words and provides translations
- Sentence Analysis Agent: Performs detailed grammatical analysis and translations
- Agent Framework: OpenAI Agents SDK handles streaming responses and tool orchestration
📁 Project Structure
lichtblick/
├── .trae/ # Trae IDE configuration
├── backend/ # Backend agent logic
│ ├── __pycache__/ # Python cache files
│ ├── .german-ai-assistant/ # German AI assistant modules
│ ├── __init__.py # Package initialization
│ └── lichtblick.py # Main agent implementation
├── frontend/ # Frontend interface
├── assets/ # Static assets
│ ├── lichtblick_mascot.png # App mascot image
│ └── logo.png # App logo
├── app.py # Main Streamlit application
├── setup.py # Package setup configuration
├── requirements.txt # Python dependencies
├── LICENSE # Project license
├── README.md # Project documentation
├── .env # Environment variables
├── .python-version # Python version (3.12.10)
├── .gitignore # Git ignore rules
└── vibe_coding_context/ # LLM context files
🎯 Learning Benefits
For German Beginners:
- Clarity: Word-by-word breakdowns make complex sentences understandable
- Grammar Support: Detailed explanations of cases, verb forms, and sentence structure
- Interactive Learning: Conversational interface encourages exploration
- Personalized Help: AI adapts responses based on your specific questions
🔑 Configuration
Required Environment Variables
OPENAI_API_KEY=sk-your-openai-api-key-here
Optional Settings
- Modify agent instructions in
backend.py - Customize UI elements in
app.py - Adjust context window (currently uses last 5 message turns)
📄 License
This project is licensed under the Apache License 2.0
🙏 Acknowledgments
- OpenAI for providing the language model APIs
- Streamlit for the web application framework
- OpenAI Agents SDK for the multi-agent architecture
📞 Contact
Ashish Soni - [email protected]
Project Link: Lichtblick
🏆 Built For
This project was created for the Trae AI IDE Agent Hackathon - a challenge to design custom agents using Trae's powerful MCP (Model Context Protocol) server capabilities. The hackathon encouraged developers to combine prompts, tools, and advanced agent architectures to create innovative AI applications.
🎯 Inspiration & Background
This project was inspired by Andrej Karpathy's insightful video "How I use LLMs" (specifically the section from 1:59:00 - 2:04:40 where he discusses using custom GPTs for language learning). Following his approach, I created a specialized AI assistant for German language learning!
Evolution of Lichtblick:
- Custom GPT Version: Originally created as a Custom GPT with specialized prompts
- Multi-Agent Implementation: Enhanced with OpenAI Agents SDK for more sophisticated tool routing
- Streamlit App: Deployed as a full web application on Hugging Face Spaces
Lichtblick means "a glimmer of hope" or "ray of light" in German - representing the clarity this assistant brings to German language learning! ✨