AILang

AI-native programming language — describe intent in natural language; the compiler emits runnable code for Python, web, mobile, IoT, and other targets.

Install from PyPI as pip install ailang-cli (PyPI reserves the short name ailang; the CLI command is still ailang). Compiler source and tests live under ailang-complete-v1.0.0/ailang-package/.

Install

pip install ailang-cli

First run (LLM onboarding)

pip does not run interactive prompts during install. Right after install, open a terminal and run ailang setup (or your first ailang compile …). The CLI walks you through choosing an LLM backend and defaults until onboarding is complete.

Full detail: ailang-docs/SETUP_AND_CONFIG.md.

After the first setup, switch LLM backends or rotate keys with ailang setup -i or ailang config set … — see Setup & config → Change settings after the first setup.

Editable install from a clone:

cd ailang-complete-v1.0.0/ailang-package
pip install -e ".[dev]"

Quick start

ailang --help
ailang compile path/to/script.ailang --target python

Documentation

Resource	Description
ailang-docs/INDEX.md	Documentation hub
ailang-docs/SETUP_AND_CONFIG.md	Onboarding, ailang setup, config file
ailang-docs/QUICKSTART.md	First successful compile
ailang-docs/LANGUAGE_REFERENCE.md	Bundled phrase vocabulary

After editing ailang_resources/vocabulary.json, regenerate the language reference:

python scripts/gen_language_reference.py

Canonical repository

https://github.com/rulhaq/ailang is the upstream home for this project. Forks, extensions, alternate vocabularies, and third-party libraries should link back here in README or package metadata (Homepage / Repository URLs) so users can find releases, security fixes, and contribution guidelines. Keep the MIT license and copyright notices when redistributing derived work. Details: ailang-docs/CONTRIBUTING.md.

Usage metrics

Public visibility into adoption uses standard platform tooling (no extra telemetry is embedded in the compiler):

What	Where
pip installs	PyPI project stats
git clones & traffic	GitHub Insights → Traffic (repository admins)
pull requests	Pull requests tab and Insights → Pulse
release assets	Per-file counts on each GitHub Release

Repository layout

Path	Purpose
ailang-complete-v1.0.0/ailang-package/	Package: ailang.py, pyproject.toml, examples/, tests/, VS Code extension
ailang-docs/	User and contributor guides
scripts/	Maintainer helpers (e.g. generated docs)

Continuous integration: .github/workflows/ci.yml (working-directory: ailang-complete-v1.0.0/ailang-package).

Links

• Issues and contributions: ailang-docs/CONTRIBUTING.md
• Code of conduct: CODE_OF_CONDUCT.md