Skip to content

xspace-lab/intercom

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

87 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“š StudyBuddy

Your AI Tutor & Study Companion built on Intercom + IntercomSwap

StudyBuddy is an intelligent tutoring system that helps students master their subjects through personalized homework help, concept explanations, and study planning. Plus, save money by trading textbooks through the IntercomSwap marketplace!

🌟 Features

  • Step-by-Step Homework Help - Never just get answers, learn the process
  • Concept Explanations - Complex topics broken down simply with analogies
  • Custom Study Plans - Schedules tailored to your deadlines and goals
  • Practice Quizzes - Test yourself on any subject
  • Essay Assistance - Writing help and proofreading
  • Textbook Marketplace - Buy, sell, or swap via IntercomSwap
  • Progress Tracking - Monitor study streaks and time invested
  • Multi-Subject Support - Math, Science, English, History, CS, and more

🎯 Why StudyBuddy?

School is challenging. StudyBuddy makes learning easier:

✨ 24/7 Tutor - Get help anytime, on any subject πŸ“Š Learn, Don't Memorize - Understand the "why" behind every concept πŸ’° Save Money - Trade textbooks instead of buying new ($60-80% savings) πŸ”₯ Stay Motivated - Track streaks and celebrate progress πŸŽ“ Personalized - Adapts to your grade level and learning style πŸ“š All Subjects - One tutor for everything

🏫 Built on Intercom + IntercomSwap

Intercom Integration:

  • Natural language homework questions
  • Conversational explanations
  • Adaptive teaching based on understanding
  • Study planning assistance

IntercomSwap Integration:

  • Student-to-student textbook marketplace
  • Trade books you're done with
  • Buy at student prices (60-80% off retail)
  • Sell your old textbooks
  • Sustainable textbook reuse

πŸ“¦ Installation

  1. Clone this repository
  2. Open interactive-demo.html in any browser - works immediately!
  3. For full AI tutoring, use index.html with your Anthropic API key

No build process, no dependencies - just pure HTML, CSS, and JavaScript.

πŸ’‘ Usage Examples

Math Help:

  • "Help me solve: 2x + 5 = 13"
  • "Explain quadratic equations"
  • "I don't understand derivatives"
  • "Show me how to factor polynomials"

Science Help:

  • "Explain photosynthesis simply"
  • "What is Newton's Third Law?"
  • "Help with my chemistry homework"
  • "Describe cellular respiration"

Study Planning:

  • "Create a study plan for my math test tomorrow"
  • "Help me prepare for midterms"
  • "Schedule my week with 3 exams"
  • "I'm behind in biology, help me catch up"

Practice & Quizzes:

  • "Quiz me on the Civil War"
  • "Test my knowledge of algebra"
  • "Give me practice problems"
  • "Create flashcards for vocabulary"

Essay Help:

  • "Help me outline my history essay"
  • "Proofread my paper"
  • "How do I write a thesis statement?"
  • "Give me feedback on this paragraph"

Textbook Marketplace:

  • "I need a calculus textbook"
  • "Find AP Chemistry books"
  • "Trade my biology book for physics"
  • "What textbooks are available?"

🎨 Interface Components

Student Sidebar

  • Profile Section - Avatar, name, grade level
  • Subject Tags - Your current classes
  • Study Stats - Streak, questions asked, study time, concepts mastered
  • Upcoming Deadlines - Exams, essays, projects

AI Chat Interface

  • Quick Actions - One-click shortcuts for common tasks
  • Natural Conversation - Ask questions in plain English
  • Visual Learning - Formatted solutions with step cards
  • Concept Tags - Highlight key ideas
  • Problem Cards - Clean math problem display

Live Features

  • Real-time stat updates
  • Question counter increments
  • Streak tracking
  • Responsive mobile design
  • Color-coded subjects

πŸ“Š What Claude Provides

Homework Solutions

β€’ Step-by-step breakdowns
β€’ "Why" behind each step
β€’ Common mistakes to avoid
β€’ Practice problems
β€’ Check your work sections

Concept Explanations

β€’ Simple language definitions
β€’ Real-world analogies
β€’ Visual descriptions
β€’ Practical applications
β€’ "Why it matters" context

Study Planning

β€’ Custom schedules based on deadlines
β€’ Time-blocked sessions
β€’ Break reminders
β€’ Subject prioritization
β€’ Study technique tips

Practice Materials

β€’ Subject-specific quizzes
β€’ Multiple choice questions
β€’ Short answer prompts
β€’ Instant grading
β€’ Explanations for wrong answers

πŸ”§ Technical Details

  • Frontend: Vanilla HTML/CSS/JavaScript
  • AI Model: Claude Sonnet 4 via Anthropic API
  • Marketplace: IntercomSwap protocol integration
  • Storage: Browser localStorage for tracking
  • Subjects: Math, Science, English, History, Computer Science, and more

πŸ”„ IntercomSwap Textbook Marketplace

What You Can Trade:

  • Textbooks (any subject, any level)
  • Study guides and workbooks
  • Test prep materials (SAT, ACT, AP)
  • Reference books
  • Previous editions (still useful!)

How It Works:

  1. List textbooks you no longer need
  2. Browse books other students are offering
  3. Propose direct swaps or purchases
  4. Meet up or ship securely
  5. Rate your trading partner

Benefits:

  • Save 60-80% vs buying new
  • Eco-friendly - reuse instead of waste
  • Student-to-student - fair pricing
  • Verified ratings - safe trades
  • Local & shipping - flexible options

Example Trades:

  • "I'll trade my Bio textbook for Chemistry"
  • "Calculus book + $20 for Physics bundle"
  • "AP History study guide for English lit book"

🎯 Use Cases

Homework Help

  • Stuck on a problem? Get step-by-step guidance
  • Don't understand a concept? Get simple explanations
  • Need practice? Get similar problems

Test Preparation

  • Create custom study schedules
  • Practice with AI-generated quizzes
  • Review weak areas identified by the AI
  • Last-minute cramming strategies

Long-Term Learning

  • Build study streaks for consistency
  • Track concepts mastered over time
  • Develop better study habits
  • Improve across all subjects

Budget-Friendly Learning

  • Trade expensive textbooks
  • Access study materials affordably
  • Build a library through swaps
  • Recoup costs when done

🌱 Future Enhancements

  • Video explanations for complex topics
  • Handwriting recognition for math problems
  • Study group features (collaborative learning)
  • Parent/teacher dashboard
  • Integration with school LMS systems
  • Adaptive difficulty based on performance
  • Subject-specific specialized tutors
  • Voice input for questions
  • Mobile app versions
  • Gamification (badges, leaderboards)

πŸ“ Intercom + IntercomSwap Competition Entry

Trac Address: [trac1krxpwpfrtkwv8rz8u39f6gxwd6ccpl48vnpq44gg8lkfhk5mmp0qhhzjjp]

This is a fork of Intercom + IntercomSwap built for the Trac Systems competition. StudyBuddy demonstrates:

βœ… Real-world educational utility βœ… Dual framework integration (tutoring + marketplace) βœ… AI-powered personalized learning βœ… Student-to-student economy (textbook swaps) βœ… Beautiful, student-friendly UI/UX βœ… Clear instructions for agents (SKILL.md)

⚠️ Disclaimer

StudyBuddy is an educational tool designed to help students learn. It should complement, not replace, classroom instruction and teacher guidance.

Academic Integrity:

  • StudyBuddy teaches HOW to solve problems, not just answers
  • Encourages understanding over copying
  • Students must do their own work
  • Use responsibly and ethically

Best Practices:

  • Try solving problems yourself first
  • Use StudyBuddy to check your work
  • Focus on learning the process
  • Ask teachers for additional help when needed

🀝 Contributing

This project is part of the Intercom + IntercomSwap ecosystem. Fork it and build your own educational tools!

πŸ“„ License

MIT License - use freely and modify

πŸ”— Links


Built with πŸ“š for students using Claude AI, Intercom, and IntercomSwap

Learning made easier, one question at a time. πŸŽ“

About

applications that leverages Claude AI, Intercom and interswap

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • HTML 55.1%
  • JavaScript 44.9%