Skip to content

lalomorales22/thermo-fun-code-lab

Repository files navigation

Thermo Fun Code Lab 🔥💻

Screenshot 2025-06-15 at 1 50 08 AM

An interactive thermodynamic computing engineering course that makes learning thermal management in computing systems fun and engaging through hands-on tutorials, visual simulations, and AI-powered assistance.

🌟 What is Thermo Fun Code Lab?

Thermo Fun Code Lab is a comprehensive educational platform designed to teach thermodynamic computing concepts through:

  • Interactive Learning Modules: Step-by-step courses covering heat transfer, thermal resistance, cooling systems, and more
  • Visual Simulations: Real-time heat transfer visualizations and thermal modeling
  • Code Playground: Interactive editors for practicing thermal calculations and simulations
  • AI Assistant: Claude 3.5 Sonnet integration for instant help with thermodynamic concepts
  • Progress Tracking: Monitor your learning journey through the course modules

🎯 Who is this for?

  • Engineering students studying thermal management
  • Computer science students interested in hardware optimization
  • Professionals working with data centers and cooling systems
  • Anyone curious about the thermal challenges in modern computing

🚀 Features

📚 Course Modules

  • Fundamentals: Basic heat transfer principles
  • Thermal Resistance: Understanding thermal pathways
  • Heat Sinks: Design and optimization
  • Thermal Interface Materials: Properties and applications
  • Fan Cooling: Airflow dynamics and optimization
  • Liquid Cooling: Advanced cooling solutions

🎮 Interactive Elements

  • Real-time heat transfer visualizations
  • Interactive code editors with live feedback
  • Progress tracking and module completion
  • Responsive design for all devices

🤖 AI Assistant

  • Powered by Claude 3.5 Sonnet
  • Expert guidance on thermodynamic concepts
  • Real-time Q&A support
  • Personalized learning assistance

🛠️ Technologies Used

  • Frontend: React 18 with TypeScript
  • Styling: Tailwind CSS
  • UI Components: Shadcn/ui
  • Build Tool: Vite
  • Charts: Recharts
  • Icons: Lucide React
  • AI Integration: Anthropic Claude API

📋 Prerequisites

  • Node.js (version 16 or higher)
  • npm or yarn package manager
  • Anthropic API key (for AI assistant functionality)

🏃‍♂️ Getting Started

1. Clone the Repository

git clone https://github.com/lalomorales22/thermo-fun-code-lab.git
cd thermo-fun-code-lab

2. Install Dependencies

npm install
# or
yarn install

3. Start Development Server

npm run dev
# or
yarn dev

4. Open the Application

Navigate to http://localhost:5173 in your web browser to start learning!

🔑 AI Assistant Setup

To use the AI assistant feature:

  1. Get an Anthropic API key from Anthropic Console
  2. Click the "AI Assistant" button in the app
  3. Enter your API key when prompted
  4. Start asking questions about thermodynamic computing!

Your API key is stored locally in your browser and never sent to our servers.

📖 How to Use

  1. Start Learning: Begin with the first module (Fundamentals of Heat Transfer)
  2. Progress Through Modules: Complete each module to unlock the next one
  3. Use Visualizations: Interact with heat transfer simulations
  4. Practice Coding: Try the interactive code examples
  5. Ask Questions: Use the AI assistant for help with concepts
  6. Track Progress: Monitor your completion status

🏗️ Project Structure

src/
├── components/          # Reusable UI components
│   ├── ui/             # Shadcn UI components
│   ├── AIAssistant.tsx # AI chat interface
│   ├── CourseHeader.tsx
│   ├── ModuleCard.tsx
│   └── ...
├── data/               # Course content and data
├── pages/              # Main application pages
├── types/              # TypeScript type definitions
└── lib/                # Utility functions

🤝 Contributing

We welcome contributions! Please feel free to:

  • Report bugs or issues
  • Suggest new features or improvements
  • Submit pull requests
  • Share feedback on the learning experience

📄 License

This project is open source and available under the MIT License.

🔗 Links

🆘 Support

If you encounter any issues or have questions:

  1. Check the existing GitHub issues
  2. Use the AI assistant within the app
  3. Create a new issue with detailed information
  4. Contact the maintainers

Happy Learning! 🎓🔥

Transform your understanding of thermodynamic computing with hands-on, interactive education.

About

thermodynamical !!

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages