# Wyn

> Wyn - the AI-native systems language: Python-simple syntax, C-fast native binaries, direct C library interop, git-URL packages, first-class concurrency; one source targets any platform.

Wyn is a compiled language that transpiles to C, then to a native binary (bundled TCC, or your system's GCC/Clang for optimized builds). It pairs a Python-like surface - structs with inline methods, `spawn`/`await` concurrency, pattern matching, traits, generics - with deterministic memory management via Automatic Reference Counting (ARC, no GC pauses). Packages are plain git repositories (no central registry): `wyn add github.com/owner/repo@tag` and publishing is `git push` + `git tag`. A C FFI (`extern fn`, `wyn bind`, and `wyn add` for 31 curated C libraries) lets Wyn call any C library directly. Current release: v1.19.1.

## Getting started

- [Installation](https://wynlang.com/docs/getting-started/installation): install Wyn on Linux, macOS, or Windows.
- [Hello, World](https://wynlang.com/docs/getting-started/hello-world): your first program, compiled and run.
- [Quick Start](https://wynlang.com/docs/guides/quick-start): a fast tour of the core workflow.
- [Learn Wyn in Y Minutes](https://wynlang.com/docs/getting-started/learn-wyn-in-y-minutes): the whole language by example.
- [CLI Commands](https://wynlang.com/docs/cli/commands): `wyn run`, `build`, `check`, `fmt`, `test`, `new`, `add`, `bind`, `pkg audit`.

## Language reference

- [Variables](https://wynlang.com/docs/language/variables)
- [Functions](https://wynlang.com/docs/language/functions)
- [Control Flow](https://wynlang.com/docs/language/control-flow)
- [Structs](https://wynlang.com/docs/language/structs)
- [Enums](https://wynlang.com/docs/language/enums)
- [Pattern Matching](https://wynlang.com/docs/language/pattern-matching)
- [Traits](https://wynlang.com/docs/language/traits)
- [Generics](https://wynlang.com/docs/language/generics)
- [Closures](https://wynlang.com/docs/language/closures)
- [Generators](https://wynlang.com/docs/language/generators)
- [Error Handling](https://wynlang.com/docs/language/error-handling)
- [Named Arguments](https://wynlang.com/docs/language/named-arguments)
- [Modules](https://wynlang.com/docs/language/modules)

## Concurrency

- [spawn / await](https://wynlang.com/docs/concurrency/spawn-await): lightweight tasks on a coroutine scheduler with cooperative I/O.
- [Channels](https://wynlang.com/docs/concurrency/channels): message passing between tasks and threads.

## C FFI

- [C FFI](https://wynlang.com/docs/language/c-ffi): `extern fn`, the `[ffi]` block in `wyn.toml`, `wyn bind` for header-driven binding generation, and `Ptr` cells for C out-parameters.

## Packages

- [Using Packages](https://wynlang.com/docs/packages/using-packages): add git-URL dependencies and the 31 curated C libraries.
- [Creating Packages](https://wynlang.com/docs/packages/creating-packages): a package is a git repo; publish with `git push` + tag.
- [Package CI](https://wynlang.com/docs/packages/package-ci): testing and releasing packages.

## Standard library

- [API Reference](https://wynlang.com/docs/stdlib/api-reference): the full standard-library index (strings, arrays, hashmap, json, file I/O, networking, web, database, crypto, datetime, math, regex, and more).

## Guides

- [From Python](https://wynlang.com/docs/guides/from-python)
- [From Go](https://wynlang.com/docs/guides/from-go)
- [Memory Model (ARC)](https://wynlang.com/docs/guides/memory)
- [Cross-Compilation](https://wynlang.com/docs/guides/cross-compile)
- [FAQ](https://wynlang.com/docs/guides/faq)
- [Version Compatibility](https://wynlang.com/docs/guides/version-compat)

## For code-generating models

- [Wyn for LLMs](https://wynlang.com/wyn-for-llms.md): one-page generation
  reference - the rules that differ from Python/JS/Rust, validated snippets for
  every core construct, and a table of the most common model mistakes with
  fixes. Designed to fit in a context window; fetch this before writing Wyn.