Hermes Agent
ed23524817
Preserve source locations, validate malformed JSON, and add opt-in resource limits. Include executable error-guide coverage, learner pilot materials, native Windows acceptance helpers, and updated CI/documentation.
2.8 KiB
Claro
A learning tool first. A programming language second.
Claro helps beginners learn programming through readable commands, simple rules, and small programs. Accessibility for people with learning disabilities is a core design goal; it still needs testing with learners.
Development version: v2026.10.25.014405
This is a development snapshot, not a newly published release. See current status and the dated release ledger for verified builds and limitations.
Start here
- Build and run Claro.
- Try your first programs.
- Follow the ten lessons, one at a time.
Build with a C89 compiler and make, then run the first lesson:
make
./claro lessons/01_hello.claro
On Windows, see the quick start for build instructions.
Your first program
SAY "Hello!"
ASK "What is your name?" name
SAY "Hello " + name
Start with input/output, variables, basic math, decisions, loops, lists, simple functions, and saving text. You do not need classes, packages, networking, or advanced types to learn with Claro.
The beginner syntax guide gives one recommended form per concept. Older forms remain supported in a separate compatibility reference.
Find your way
lessons/— small, ordered lessons.examples/— programs to try and change.- Documentation — learning guides and reference.
- Current roadmap — the small set of active priorities.
- Learning-first rules — how Claro is designed.
- Active learning-first roadmap — current priorities; older platform plans are historical context.
- Contributing — source layout, builds, and validation.
Existing features and compatibility syntax remain supported; they are not required for the beginner path. Experimental features are described in the detailed status, not promised as ready.
Claro scripts run with your permissions. Run only scripts you trust.
Single-file C89 interpreter
The complete runtime is in src/claro.c. Build it directly:
gcc -std=c89 -pedantic-errors src/claro.c -o claro -lm
No generated source or project header is required. See C89 build notes for platform dependencies, testing, and limitations.
Downloads and portability
Use the distribution guide to build and verify clean source, Linux x86-64, and Windows x86-64 archives. Windows execution is tested under Wine, not yet on a native Windows machine. For VC6 / Windows 98 SE compilation, use build98.bat and its guide.
License
See LICENSE.