BaseCraft

Easy automation for non-programmers

Just tell AI what you want — it writes the code, you run it.

فارسی · Español

---

BaseCraft is not an AI tool. It doesn't compete with Hermes, OpenClaw, or anything else. It's a starter project that provides two facilities: helping non-developers vibe-code their basic tasks more easily and reliably. It has a good foundation for LLMs to understand user input and develop code and programs that are more reliably bug-free. However, to target average users, I have created a small but thorough tutorial on how to work with this project.

Yes, you can build complex stuff with it too — though that's not what this project aims for.

Output2.mp4

Tutorial for windows users

Prerequisites

• A laptop or PC
• Knowing how to use the said laptop or PC
• The will to start developing :)

How It Works

You tell AI what you want
        ↓
AI writes the code
        ↓
You save the file
        ↓
You run it
        ↓
Task done!

Example: You say "I have 100 photos. Combine them into a 10x10 grid." AI writes the code, tells you where to save it, you double-click to run, and you get your grid.

Quick Start

1. Download — Click the green <> Code button → "Download ZIP" → extract to Desktop
2. Install — Open the BaseCraft folder → double-click install.bat (or run bash install.sh on Mac/Linux)
3. Upload — Open an AI chatbot, upload AGENTS.md and os.txt, tell AI what you want

Important: If this is your first time, read the Getting Started guide first. It walks you through everything step by step — how to open a terminal, how to save files, how to run scripts. Don't skip it if you don't know them.

Want an easier experience? The Advanced guide sets up a coding agent — this lets AI work directly on your files. No copy-paste, no saving files manually. It takes extra effort to set up, but after that every task is much simpler. This project works best with the advanced setup, though it also works fine with the basic setup.

Guides

Guide	For who
Getting Started	First-time users — terminal basics, install, first task
Advanced	Coding agents — easier daily use, one-time setup

License

MIT License - 2026 Hamidreza Zamanian