README.md

---
title: Ashok 2.0 - Problem Solving Assistant
emoji: 🧠
colorFrom: blue
colorTo: purple
sdk: streamlit
sdk_version: 1.29.0
app_file: app.py
pinned: false
license: mit
---

# 🧠 Ashok 2.0 - Learning Problem Solving Assistant

A smart, learning-enabled chatbot that specializes in problem-solving advice with an authentic Pakistani/Indian conversational style. Ashok learns from every conversation and gets smarter over time!

## ✨ Key Features

### 🎓 **Intelligent Learning System**
- **Learns from conversations**: Every helpful Q&A is remembered and used for future responses
- **Smart question filtering**: Automatically blocks silly questions with humorous "Abay Sallay" responses
- **Quality-based learning**: Only learns from meaningful problem-solving discussions
- **Source attribution**: Clearly shows whether advice comes from uploaded books or learned conversations

### 📚 **Enhanced Knowledge Integration**
- **Upload PDF books**: Add problem-solving books to enhance Ashok's knowledge base
- **Multi-source responses**: Combines book knowledge with learned experiences
- **Chapter/page references**: Cites specific sources for credibility
- **Core frameworks**: Comes pre-loaded with essential problem-solving methodologies

### 💬 **Authentic Conversational Style**
- **Bilingual charm**: Natural English-Urdu mixing ("yaar", "samjha", "bilkul")
- **Cultural authenticity**: Genuine Pakistani/Indian conversational patterns
- **Encouraging tone**: "Excellent question yaar!", "Bahut acha sawal!"
- **Practical focus**: Always provides actionable, real-world advice

## 🚀 How to Use

### 1. **Get Your API Key**
- Visit [Google AI Studio](https://makersuite.google.com/app/apikey)
- Sign in with your Google account
- Create a new API key (it's completely free!)
- Copy the key

### 2. **Start Chatting**
- Enter your API key in the sidebar
- Ask detailed problem-solving questions
- Watch Ashok learn and improve with each conversation!

### 3. **Optional: Upload Books**
- Upload PDF books about problem-solving, management, or leadership
- Ashok will process and integrate the content
- Get responses that reference specific chapters and pages

## 💡 Example Questions

### ✅ **Great Questions** (Ashok loves these!)
- *"How can I improve my team's decision-making process?"*
- *"What's the best approach to handle workplace conflicts?"*
- *"Can you explain effective problem-solving frameworks?"*
- *"How do I prioritize when everything seems urgent?"*
- *"What strategies work for managing difficult stakeholders?"*

### ❌ **Silly Questions** (Get "Abay Sallay" responses!)
- *"Hi, how are you?"*
- *"What's your favorite color?"*
- *"Tell me a joke"*
- *"What's the weather like?"*

## 🎯 Problem-Solving Topics Covered

- **Decision Making**: Frameworks, criteria, evaluation methods
- **Conflict Resolution**: Mediation, negotiation, win-win solutions
- **Team Management**: Leadership, communication, productivity
- **Strategic Thinking**: Planning, analysis, long-term vision
- **Creative Problem Solving**: Innovation, brainstorming, design thinking
- **Critical Thinking**: Analysis, evaluation, logical reasoning
- **Project Management**: Planning, execution, risk management

## 🔧 Technical Features

### **Smart Architecture**
- **FAISS vector database**: Fast, efficient similarity search
- **HuggingFace embeddings**: High-quality text understanding
- **Session persistence**: Knowledge retained during your visit
- **Quality scoring**: Automatic assessment of conversation value

### **User Experience**
- **Real-time learning**: See when Ashok learns from your conversation
- **Knowledge statistics**: Track total documents, conversations, and learning progress
- **Source transparency**: Always know where information comes from
- **Responsive design**: Works great on desktop and mobile

## 🛡️ Privacy & Security

- **No data storage**: Your conversations are only kept during your session
- **API key security**: Your key is never stored or logged
- **Local processing**: All AI processing happens through your own API key
- **Open source**: Full transparency in how your data is handled

## 🎪 The "Abay Sallay" Experience

Ashok has a unique personality! Ask silly questions and you'll get authentic responses like:
- *"Abay Sallay! Don't waste my time with such bakwas. Ask me something related to problem solving yaar!"*
- *"Abay Sallay! This is a problem-solving platform. Be serious!"*
- *"Abay Sallay! Focus on real problems that need solving, samjha?"*

This isn't just for fun - it encourages users to ask meaningful, detailed questions that lead to better problem-solving advice!

## 🔄 Local Development

Want to run this locally or customize it? Here's how:

```bash
# Clone the repository
git clone <your-repo-url>
cd ashok-2.0

# Install dependencies
pip install -r requirements.txt

# Run locally
streamlit run app.py
```

### **For Persistent Learning** (Local Only)
The local version includes additional features:
- Knowledge base persists between sessions
- Automatic backups
- Advanced analytics
- Book pre-processing during deployment

## 🤝 Contributing

Found a bug or have a suggestion? We'd love to hear from you!
- Improve the silly question detection
- Add new problem-solving frameworks
- Enhance the learning algorithms
- Suggest better "Abay Sallay" responses 😄

## 📞 Support

If you encounter any issues:
1. Check that your Gemini API key is valid
2. Ensure you're asking problem-solving related questions
3. Try refreshing the page if you see any errors
4. For persistent issues, please report them in the community tab

---

**🎯 Ready to solve problems with Ashok? Get your free API key and let's start! 🚀**

*Made with ❤️ for problem-solvers everywhere*