README.md

metadata

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
• 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:

# 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