Suro

💡 Inspiration

We've all been there: drowning in textbooks, confused by complex concepts, and stressing over upcoming exams. Static notes are boring, and generic chatbots often lack the context of who we are and what we are studying.

We wanted to build something more than just a search engine—we wanted a proactive study partner. We built Suro 0.2 to be an intelligent agent that doesn't just answer questions but visualizes them, quizzes you, and actually speaks to you, making learning interactive and personalized.

🤖 What it does

Suro 0.2 is an AI-powered agent designed to streamline the study process. It acts as a personalized tutor with the following core capabilities:

• 🎙️ Generative Voice: Suro doesn't just display text; it can explain concepts aloud, making it perfect for auditory learners.
• 📊 Visual Learning (Mermaid.js): Complex flows and processes are automatically converted into clear Mermaid charts (rendered as PNGs) for instant visualization.
• 📝 Dynamic Quizzes: It generates MCQ-based quizzes on the fly to test your knowledge on specific topics.
• 👤 Personalization Engine: The profile system tracks the user's specific details—name, upcoming exams, and test schedules—to tailor the study plan and reminders.
• 💻 Rich Rendering: Supports full Markdown rendering, including neat tables for data comparison and code boxes for programming study.

⚙️ How we built it

We built Suro 0.2 using a modular agent-based architecture:

• Frontend: Built with [Insert Framework, e.g., React/Next.js] to create a "Good UI" that is clean and distraction-free.
• AI & Logic: We utilized [Insert AI Model, e.g., OpenAI/Gemini] for the reasoning engine.
• Visualization: Integrated Mermaid.js to programmatically generate charts and graphs from text descriptions.
• Voice: Used [Insert TTS API, e.g., ElevenLabs/Web Speech API] for high-quality text-to-speech generation.
• Data Handling: [Insert DB, e.g., Firebase/MongoDB] stores user profiles, exam dates, and study history.

🧠 Challenges we ran into

One of the biggest challenges was ensuring the Mermaid chart generation was accurate. Hallucinating code syntax often breaks the rendering, so we had to implement strict prompting and error handling to ensure the charts generated correctly every time. Additionally, keeping the UI responsive while streaming both voice and text required careful state management.

🏅 Accomplishments that we're proud of

• Successfully integrating text-to-chart generation—seeing a complex paragraph instantly turn into a flow chart is magical.
• Building a personalized context window where the AI actually remembers your upcoming exams and adapts its tone.
• Achieving a polished, aesthetically pleasing UI that supports rich Markdown formatting seamlessly.

🚀 What's next for Suro 0.2

• File Uploads: allowing users to upload PDFs for Suro to analyze.
• Spaced Repetition: Integrating an algorithm to schedule quizzes based on the user's exam dates.
• Mobile App: Porting the web interface to a native mobile experience.

Built With

• css
• flask
• groq
• html
• javascript
• langchain
• langgraph
• mermaid.js