TinkerAI is an intelligent, browser-based Arduino and AVR circuit simulation platform with built-in AI capabilities. It allows makers, students, and engineers to design, test, and troubleshoot electronic circuits seamlessly through a highly interactive, 100% local interface.
Describe a circuit in plain text (e.g., "Blink an LED" or "Motor speed controller"), and TinkerAI's Self-Trained Generative Expert System will automatically generate the complete circuit, adding and connecting the necessary components. No cloud APIs required.
The safety engine continuously monitors your circuit (checking every 2 seconds) with over 15+ safety checks to identify risks such as:
- Short circuits
- Reverse polarity
- Voltage mismatches
- Overcurrent risks
- Missing grounds or floating pins
When issues are found, TinkerAI provides clear warnings and one-click "✨ Auto-Fix" solutions to correct the circuit immediately.
Access an expanded registry of over 200 components with an instant semantic search feature. Available components include:
- Microcontrollers (10+): Arduino Uno/Nano/Mega/Due, ESP32, ESP8266, STM32, ATtiny, Raspberry Pi Pico
- Sensors (20+): Distance, Environmental, Motion, Optical, Gas, Moisture
- Actuators (12+): DC motors, Servo motors, Stepper motors, Solenoids
- Displays (15+): LCDs, OLEDs, TFT, E-Ink, 7-Segment, WS2812B LEDs
- Communication (9+): Bluetooth, WiFi, RF, LoRa, GSM, GPS
- Power & Drivers: Voltage regulators, motor drivers, logic level converters
Load 12+ ready-made templates categorized by difficulty (Beginner, Intermediate, Advanced). Each project template includes:
- Auto-generated Bill of Materials (BOM) with pricing estimates
- Step-by-step assembly instructions (6-step guides)
- Ready-to-use Arduino code
- Troubleshooting guides and multi-format export
Simulate potential changes before building them in the real world. Test scenarios like swapping out a microcontroller or changing input voltages to evaluate the impact, risks, and recommendations provided by the local AI analyzer.
- Core Framework: Vite, Vanilla JavaScript / HTML, CSS3
- Simulation Engine: AVR8js
- Code Editor: CodeMirror 6
- AI Engine Stack: 100% Local Rule-Based Expert System (No Cloud, No External APIs, Offline Capable)
- Storage: IndexedDB for local component caching
Make sure you have Node.js installed on your machine.
-
Clone the repository:
git clone https://github.com/Somil450/TinkerAI.git cd TinkerAI -
Install dependencies:
npm install
-
Start the development server:
npm run dev
-
Build for production:
npm run build
Open index.html (or the local URL provided by Vite) in your browser to start building circuits!
For a rapid overview on how to use the interface, read the Quick Start Guide. More in-depth technical documents are available in the repository:
- Quick Start Guide - Learn how to use the AI panel and simulator in under a minute.
- Architecture Guide - Deep dive into how the system is designed.
- AI Implementation Guide - Details on how the AI and safety monitoring features are implemented.
- Implementation Complete - View the completed delivery summary of the system.
TinkerAI operates entirely within your browser. There is no data collection, no external network requests for AI, and no cloud dependency. Everything runs locally, ensuring complete privacy and offline operation capability.
Contributions, issues, and feature requests are welcome! Feel free to check the issues page or submit pull requests to help improve the simulation capabilities.
This project is open-source. (See LICENSE file for details if available).