dimgigov
32dbd1fc5d
- Remove leading blank line and --- separator before H1 in 03-ai-integration.md (EN + BG) to prevent markdown rendering issues - Fix broken language switcher links in en/index.md and bg/index.md - Add documentation TOC tables to both index files for proper navigation
2.4 KiB
2.4 KiB
Bara Lang Documentation
A Clojure dialect that compiles to Nim → C → native binaries. The only standalone Clojure implementation completely free from the Java ecosystem.
Choose Language / Избор на език
| 🇬🇧 English | 🇧🇬 Български |
|---|---|
| English Documentation | Българска Документация |
Quick Links
- GitHub/GitLab: lisp-nim
- Build:
make build && make check - Tests: 276+ tests across 8 test suites
- AI Integration: DeepSeek API, OpenAI-compatible, Xiaomi MiMo
- Test Suite: Clojure Test Suite Compatibility — cross-dialect compliance testing
Documentation
| # | Topic | File |
|---|---|---|
| 1 | Getting Started | 01-getting-started.md |
| 2 | Architecture | 02-architecture.md |
| 3 | AI Integration | 03-ai-integration.md |
| 4 | API Reference | 04-api-reference.md |
| 5 | User Guide | 05-user-guide.md |
| 6 | Roadmap | 06-roadmap.md |
| 7 | Clojure Test Suite | 07-clojure-test-suite.md |
Why Bara Lang?
Unlike every other Clojure dialect, Bara Lang has zero dependency on the Java ecosystem — no JVM, no GraalVM, no Google Closure Compiler, no Java standard library.
| Dialect | Java Ecosystem Dependency |
|---|---|
| Clojure (JVM) | Full — runs on JVM |
| ClojureScript | Heavy — Google Closure Compiler |
| Babashka | Medium — GraalVM native-image |
| Bara Lang | None — completely standalone |
Unique Advantages
- Native HAMT Persistent Data Structures — Built from scratch in Nim (Persistent Vector, Map, Set with structural sharing)
- Multiple Targets — Native binary, shared library (.so/.dll), WASM, and JavaScript from one codebase
- AOT Compiler — Clojure → Nim → C → native, running at C speed
- Nim/C Interop — Direct FFI without JVM bridging overhead
- AI-Native Tooling — Built-in AI integration for code generation, optimization, and debugging
- Concurrency Without JVM — Atoms, Agents, and core.async channels without Java threads
- Tiny Binaries — Single executables under 1MB with no runtime dependencies