# Project export: Aesop.ai This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small. ## Project metadata - Hackathon: Cal Hacks 11.0 - Tagline: Avengers! When kids hear that they think FUN! Yet, when kids hear learning they Cry! AESOP uses generative AI to allow their favorite superheros into dynamic mentors to them about educational topics. - Devpost: https://devpost.com/software/alsop-ai - GitHub: https://github.com/Devanshusp/aesop.git - Team: 2 GitHub contributor(s) — Devanshu Sen Pandey (32 commits), brad (12 commits) ## Devpost submission (written by the team) ### Inspiration We are passionate about teaching and inspiring kids to succeed. After brainstorming, we discovered that we all had relatable frustrations of being unable to engage children to learn school topics from our tutoring experiences. All the kids would love to talk about the latest superhero movies and would rather listen and talk about them than to engage with us. Knowing that, we decided to harness the generative AI and let the heroes take over the teaching from us. ### What it does Utilizes multimodal AI agents to generate text and illustrations to create engaging and interactive choose-your-own educational adventures. The child picks his favorite character, his grade, and the subject he wants to learn so that they can build their own unique experience ### How we built it We utilized: Groq's LiteLLM and LPU backend to generate text for our stories. Reflex's pure-Python and batteries-included approach to Web apps to accelerate our front and backend development Cartesia to build a clone superhero voice for superhero narrations. Hyperbolic's Dall-E 3 to create imaginative images based on the text provided ### Challenges we ran into Implementing the vector database and content databases. Getting around the Reflex's data modeling limitations Implementing tracing with Arize Phoenix for child safety. ### Accomplishments we're proud of We are proud of our end to end product. We are proud of how the we completed the process of how we completed the process of brainstorming to building a product in 36 hours. We can proudly say that we built a product that can potentially be used for an socially positive use case . ### What we learned We learned how there can be a lot of problems throughout the project process and we learned that persistencey is the key. We learned that communication is especially important in relaying and solving problems. As for the techinal side we learned a lot about how to use git along with learning how to string together different AI agents to become one successful product. ### What's next chromadb to create vector databases that store word embeddings and enable fast searches. As Arize Phoenix's API had a bit of learning curve and child safety is an important issue worth deep discussions, Implementing tracing has become our next time priority Accessibility features: Multilingual support, dyslexic and learning handicap features -Fetch.ai to connect to agent-verse ## README (from the GitHub repository) No README available. ## Detected evidence (automated analysis) Indexed codebase: 31 recognized source files, 48 KB. - Python (language) — detected in the code - Supabase (technology) — detected in the code ## Codebase structure (from repository index) ### Files (36 of 36) ``` .gitignore aesop/__init__.py aesop/aesop.py aesop/backend/dboperations.py aesop/backend/embeddings.py aesop/backend/generate_story.py aesop/backend/llm/__init__.py aesop/backend/llm/llm_api.py aesop/backend/llm/llm_model.py aesop/backend/llm/llm_provider.py aesop/backend/llm/prompts.py aesop/frontend/components/footer.py aesop/frontend/components/header.py aesop/frontend/components/login.py aesop/frontend/components/logo.py aesop/frontend/pages/create.py aesop/frontend/pages/home.py aesop/frontend/pages/story.py aesop/frontend/pages/talk.py aesop/frontend/utils.py aesop/models/__init__.py aesop/models/llm_message.py aesop/models/story_card.py aesop/models/story_content.py alembic.ini alembic/env.py alembic/README alembic/script.py.mako alembic/versions/00510c65088f_.py alembic/versions/f75081739d96_test.py config.py config.yaml docker-compose.yml README.md requirements.txt rxconfig.py ``` ### Dependencies - requirements.txt: Authlib@==1.3.2, h2@==4.1.0, litellm@==1.50.0, pillow@==11.0.0, psycopg2-binary@==2.9.10, pydantic-settings@==2.6.0, reflex-clerk@==1.0.3, supabase@==2.9.1 ### Recent commits (newest first) - Merge pull request #18 from Devanshusp/ai-components - working published - audio components - Merge pull request #17 from Devanshusp/agents-jooho - db ops complete - complete - handoff to dev - Merge pull request #16 from Devanshusp/agents-jooho - rxconfig update - updated - Merge pull request #15 from Devanshusp/ai-components - text_generation - localized - Merge pull request #14 from Devanshusp/frontend-devanshu - more login stuff - more login stuff - Merge pull request #13 from Devanshusp/frontend-devanshu - renamed some pages, talk page created, required signin for certain pages - Merge pull request #12 from Devanshusp/frontend-devanshu - Merge pull request #11 from Devanshusp/reflexbackend-jooho#2 ## Key source files (fetched from GitHub, selected and truncated for size) Source contents could not be fetched from GitHub right now. [30 more indexed source files omitted to keep this export small. The full file list is in the Codebase structure section above.]