🕉️ தமிழ்த்திறன் (Thamizh Thiran) 📿

AI-Powered Traditional Tamil Wisdom Application

"அறிவே ஆற்றல்" - Knowledge is Power

---

🌟 Overview

Thamizh Thiran is an innovative Streamlit web application that bridges ancient Tamil wisdom with modern AI technology. Get personalized guidance from traditional Tamil literature, proverbs, and philosophical teachings through an intelligent AI assistant powered by Sarvam AI.

Whether you're seeking life advice, spiritual guidance, or business wisdom, this app delivers authentic Tamil knowledge with English translations, making ancient wisdom accessible to modern seekers.

✨ Features

🎯 Core Functionality

• AI-Powered Wisdom: Get personalized Tamil guidance using Sarvam AI
• Bilingual Support: Questions in Tamil or English, responses in both languages
• Multiple Categories: Access different types of traditional knowledge
• Random Wisdom: Discover unexpected insights with random question generation
• Wisdom History: Track and revisit your previous queries
• Offline Fallback: Continues working even when API is unavailable

📚 Wisdom Categories

Category	Description
📖 திருக்குறள் (Thirukkural)	Timeless couplets from Thiruvalluvar
🗣️ பழமொzhிகள் (Proverbs)	Traditional Tamil proverbs and sayings
🌱 வாழ்க்கை அறிவுரை (Life Advice)	Practical guidance for successful living
❤️ காதல் கவிதை (Love Poetry)	Romantic wisdom and love poetry
🕉️ ஆன்மீகம் (Spirituality)	Spiritual thoughts and philosophical insights
💼 வணிக புத்திசாலித்தனம் (Business Wisdom)	Traditional business acumen and success principles

🎨 User Experience

• Beautiful Tamil-inspired UI with custom CSS styling
• Real-time Statistics tracking your wisdom journey
• Responsive Design that works on all devices
• Interactive Elements with smooth animations
• Color-coded Categories for easy navigation

🚀 Getting Started

Prerequisites

Python 3.7+
Streamlit
Requests library
Sarvam AI API access

Installation

1. Clone the repository

git clone https://github.com/SH-Nihil-Mukkesh-25/thamizh-thiran.git
cd thamizh-thiran

2. Install required packages

pip install streamlit requests

3. Set up your API key

# In the code, replace "YOUR_API" with your actual Sarvam AI API key
headers = {
    "Authorization": "Bearer YOUR_SARVAM_AI_API_KEY",
    "Content-Type": "application/json"
}

4. Run the application

streamlit run app.py

5. Open your browser and navigate to http://localhost:8501

🛠️ Configuration

API Setup

1. Sign up for Sarvam AI API access
2. Get your API key from the dashboard
3. Replace YOUR_API in the code with your actual API key

Customization Options

• Add new wisdom categories by modifying the WISDOM_CATEGORIES dictionary
• Customize fallback wisdom by editing the get_fallback_wisdom() function
• Modify UI colors and styling in the custom CSS section
• Adjust API parameters like temperature and max_tokens for different response styles

📱 Usage Examples

Basic Question

Question: "வாழ்க்கையில் வெற்றி பெற என்ன செய்ய வேண்டும்?"
Category: வாழ்க்கை அறிவுரை (Life Advice)

English Question

Question: "How to find inner peace?"
Category: ஆன்மீகம் (Spirituality)

Business Inquiry

Question: "What are the keys to successful business?"
Category: வணிக புத்திசாலித்தனம் (Business Wisdom)

🏗️ Architecture

Components

• Frontend: Streamlit with custom CSS for Tamil-inspired design
• Backend: Python with requests for API communication
• AI Service: Sarvam AI for generating contextual Tamil wisdom
• Fallback System: Local wisdom database for offline functionality
• State Management: Streamlit session state for user data persistence

Data Flow

User Question → Category Selection → API Request → AI Processing → 
Tamil Wisdom Generation → Bilingual Response → UI Display → History Storage

🎨 Design Philosophy

The application follows these design principles:

• Cultural Authenticity: Respectful representation of Tamil culture and wisdom
• Accessibility: Bilingual support for broader reach
• User-Centric: Intuitive interface with minimal learning curve
• Reliability: Robust fallback system ensures continuous functionality
• Beauty: Aesthetically pleasing design that honors Tamil heritage

🔧 Technical Features

Error Handling

• API Failure Recovery: Automatic fallback to offline wisdom
• Input Validation: Prevents empty queries and handles edge cases
• Connection Timeout: Graceful handling of network issues

Performance Optimizations

• Efficient API Calls: Optimized payload structure
• Caching Strategy: Session state management for better UX
• Responsive UI: Fast rendering with minimal computational overhead

Security Considerations

• API Key Protection: Environment variable support recommended
• Input Sanitization: Safe handling of user inputs
• Error Message Sanitization: No sensitive information exposure

🤝 Contributing

We welcome contributions to make Thamizh Thiran even better!

Ways to Contribute

1. Add more wisdom categories
2. Improve Tamil translations
3. Enhance UI/UX design
4. Add new features
5. Fix bugs and improve performance
6. Improve documentation

Development Setup

# Fork the repository
git fork https://github.com/yourusername/thamizh-thiran.git

# Create a feature branch
git checkout -b feature/amazing-feature

# Make your changes and commit
git commit -m "Add amazing feature"

# Push to your fork and submit a pull request
git push origin feature/amazing-feature

🐛 Known Issues

• API rate limiting may affect response times during peak usage
• Some complex Tamil characters may not render perfectly on all systems
• Mobile responsiveness can be improved for very small screens

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

SH Nihil Mukkesh

• LinkedIn: SH Nihil Mukkesh
• Created with ❤️ for preserving and sharing Tamil wisdom

🙏 Acknowledgments

• Sarvam AI for providing the AI infrastructure
• Tamil Literature Community for preserving ancient wisdom
• Streamlit Team for the amazing framework
• Open Source Community for inspiration and support

தமிழ்த்திறன் - Where Ancient Wisdom Meets Modern Technology

⭐ Star this repo | 🍴 Fork it | 📫 Get in touch