WordPecker: Revolutionizing Language Learning with AI Technology

Every word tells a story, every lesson is personalized

Have you ever faced these frustrations?
📖 Constantly looking up words while reading foreign books breaks your immersion?
🗣️ Struggling to recall learned vocabulary during real conversations?
🌍 Progress stalling due to lack of language environment?

WordPecker is designed to solve these pain points. Combining Duolingo-style engaging learning with personalized vocabulary management, this AI-powered application integrates language acquisition into your daily life context.

1. Why Traditional Learning Methods Are Inefficient

Before exploring WordPecker, let’s examine core limitations of conventional approaches:

2. Revolutionary Feature Breakdown

🌟 Vision Garden

Learning Method: Describe AI-generated scenes (markets/forests/cities), while the system analyzes your descriptions and recommends missing key vocabulary.
Technical Core:

• LLM compares your descriptions with standard versions
• Recommends appropriate new words based on current vocabulary level
• Automatically anchors memories to visual scenes

Video Demo

🚀 Smart Vocabulary Discovery

Workflow:

1. Select interest topics (e.g., “space exploration”)
2. Set difficulty level
3. Engage with “Know/Don’t Know” interface

# Interactive Interface Example
[Word] astrophysics  
[ ] I know   [✓] Don't know  

► After clicking "Don't know":  
📖 Definition: The branch of astronomy concerned with physical properties of celestial objects  
💬 Example: "Astrophysics studies the physics of stars and galaxies..."  
🖼️ Associated Image: (Auto-generated space visualization)

Technical Advantages:

• Automatically excludes mastered words
• Generates level-appropriate vocabulary
• Visual memory enhancement

🗣️ Real-Time Voice Conversations

Innovative Experience:

• Discuss learning vocabulary with AI tutor
• Instant pronunciation correction
• Add new words to collections through dialogue

# Sample Conversation
You: "How to use 'negotiate' in a sentence?"  
AI: "We'll negotiate the contract terms tomorrow.  
     Add to 'Business Meetings' collection?"  

Conversation Demo

🔍 Word Exploration Hub

Each word features a dedicated knowledge map:

graph LR
A[bank] --> B{Finance Collection}
A --> C{Geography Collection}
B --> D[Definition: Financial institution]
B --> E[Example: Open a bank account]
C --> F[Definition: River edge]
C --> G[Example: River bank]

Core Features:

• Cross-collection context comparison
• One-click multilingual example generation
• Similar word recommendation system
• Visual memory reinforcement tools

3. Dual Learning Pathways

🗺️ Discovery Learning Path

1. Vision Garden → Discover new vocabulary  
2. Add to existing/new collections  
3. Deep learning in word hub  
4. Voice conversations + reading reinforcement  
5. Multidimensional practice  

📚 Traditional Learning Path

1. Manually create collections (e.g., "Cooking Terms")  
2. Input encountered words → Auto-generated definitions  
3. Expand related vocabulary in word hub  
4. Generate thematic reading materials  
5. Customized exercise training  

4. Technical Architecture & Setup Guide

⚙️ System Architecture

graph TB
A[Frontend] -->|ReactJS| B[Backend]
B -->|ExpressJS| C[AI Services]
C --> D[OpenAI]
C --> E[ElevenLabs]
B --> F[MongoDB]

🐳 Recommended Docker Installation

Prerequisites:

• Docker environment
• OpenAI API key

3-Step Launch:

# 1. Clone repository
git clone https://github.com/baturyilmaz/wordpecker-app.git
cd wordpecker-app

# 2. Configure environment variables
cp .env.docker .env  # Insert API keys

# 3. Launch services
docker-compose -f docker-compose.dev.yml up --build

Access Points:

• Frontend: http://localhost:5173
• API: http://localhost:3000
• Database: mongodb://admin:password@localhost:27017

5. Technical Highlights

🌐 Multilingual Hybrid Learning

Breakthrough Design:

• Any language combination (e.g., learn Japanese using French)
• Dialect precision (Brazilian vs. European Portuguese)
• Kana system support (Japanese Hiragana/Katakana)

🎚️ Configurable Training System

# Exercise Configuration:
[✓] Multiple choice  
[✓] Fill-in-the-blank  
[✓] Matching  
[✓] True/False  
[ ] Sentence completion  # Disable specific formats

6. Development Roadmap

🚧 Recent Updates

- [x] Voice conversation system (2023 Q4)  
- [x] Vision Garden (2024 Q1)  
- [x] Multi-exercise support (2024 Q2)  

🔭 Future Development

7. Frequently Asked Questions

❓ Is programming knowledge required?

Not at all. Docker enables one-click launch with intuitive graphical interface.

❓ Does it support offline use?

Current version requires internet (AI dependency). Offline mode is on the roadmap.

❓ How is data security ensured?

All data stored in local MongoDB. Configure separately via docker-compose.mongo.yml.

❓ Is it free?

Open-source MIT license. Users provide their own API keys for OpenAI/ElevenLabs.

8. Start Your Personalized Learning Journey

Core Value Proposition:

“Adapting materials to you – not you to materials”

By integrating AI with language cognition science, WordPecker delivers:
✅ Contextual Memorization – Words anchored to usage scenarios
✅ Active Discovery – Beyond passive memorization
✅ Multidimensional Reinforcement – Visual/auditory/textual channels

Launch Now:

git clone https://github.com/baturyilmaz/wordpecker-app.git
# Detailed guide at /docs/startup-guide.md

Language isn’t accumulated knowledge – it’s new cognitive territory.
WordPecker doesn’t teach you – it guides your exploration.