Thagore Developer Docs

Thagore Developer Docs

Thagore is a statically-typed, compiled systems language that produces native binaries via LLVM IR. It features Python-like syntax with indentation-based scoping, a self-hosted compiler, and a unique intent system for declarative programming patterns.

Start Coding in 10 Minutes

New to Thagore? Follow the Quick Start: Install Thagore guide to go from zero to your first compiled program.

Philosophy

Why Thagore exists, design goals, and practical trade-offs.

Install & Tooling

Quick start installation guide, bootstrap, CLI usage, and OS-specific setup.

Language Syntax

Complete syntax reference: variables, functions, control flow, structs, imports, and advanced features.

Compiler Internals

How the compiler works: lexer, parser, typechecker, lowering, LLVM emitter, and runtime bridge.

Standard Library

API reference for every built-in module: fs, env, process, string, io, path, http, time, list, and map.

Type System

Static typing model, type inference, supported primitive and composite types.

Patterns & Idioms

Idiomatic patterns, common pitfalls, debugging strategies, and real-world examples.

Integration

C FFI, Python bridge, PyTorch interop, and external system playbooks.

Memory Model

String management, pointer operations, heap allocation, and the managed runtime.

Reference

Feature compatibility matrix, supported platforms, and LLVM version requirements.

Contributing

How to contribute: first PR guide, coding standards, and CI requirements.

Quick Start Path

1. Install Thagore — download a pre-built release and run your first program (5 min).
2. Read Why Thagore to understand the design philosophy.
3. Learn the Syntax Guide — start with Print, Input, and Variables.
4. Explore the Standard Library for built-in APIs.
5. Study Patterns & Idioms for best practices.
6. Read Contributing to submit your first PR.

Key Features at a Glance

Feature	Description
Static Typing	Full type inference with explicit annotations (i32, f32, String)
LLVM Backend	Native code generation via LLVM 21 (x86-64, ARM64)
Self-Hosted	Compiler written in Thagore itself
Python-like Syntax	Indentation-based blocks, : terminators, clean function declarations
C FFI	Direct extern func declarations to call any C library
Python Bridge	Seamless interop with Python and PyTorch
Intent System	Declarative, constraint-based programming patterns
Operator Overloading	impl blocks with __add__, __mul__, etc.
Module System	import for local files and standard library modules