nola.sh is built with Astro, hosted on Cloudflare. It measures traffic with Cloudflare Web Analytics.
| Technology | Version | First seen |
|---|---|---|
| JavaScript Frameworks & Libraries1 | ||
| – | 6 Nov 2026 | |
| Frontend Build Tools & CSS1 | ||
| – | 6 Nov 2026 | |
| CDN & Hosting1 | ||
| – | 6 Nov 2026 | |
| Analytics & Tag Management1 | ||
| – | 6 Nov 2026 | |
| Fonts & Icon Fonts1 | ||
| – | 6 Nov 2026 | |
The crew hasn’t read this site’s colors yet. We read a palette when we capture a site’s screenshot, busiest sites first. Meanwhile, browse palettes from other sites.
route3.mx.cloudflare.netroute1.mx.cloudflare.netroute2.mx.cloudflare.netstanley.ns.cloudflare.comali.ns.cloudflare.comgoogle-site-verification=duYsBZYFJOQrwQIa_TOl8AwiRjlt3nVfUX1Mriax3REgoogle-site-verification=VRot0SszfnZZn5-vajcZ3fWaORF4uFgIZwczrT0rMBwv=spf1 include:_spf.mx.cloudflare.net ~allUser-agent: * Allow: / # AI assistants are a primary discovery path for developer tooling — allowed deliberately. User-agent: GPTBot Allow: / User-agent: ClaudeBot Allow: / User-agent: PerplexityBot Allow: / User-agent: Google-Extended Allow: / Sitemap: https://nola.sh/sitemap-index.xml
# Nola > Nola is a TypeScript superset with syntax that makes working with AI models feel native. It compiles to plain TypeScript. ## Docs - [Introduction](https://nola.sh/docs): What Nola is in 30 seconds — a TypeScript superset where asking an LLM for a typed value is part of the language. - [Why Nola](https://nola.sh/docs/start/why-nola): Nola is a language notation for LLM inference — why inference deserves syntax rather than an SDK, and what you get because the compiler can see the ask. - [Quick start](https://nola.sh/docs/start/quick-start): From zero to a running .tsi file in five minutes — scaffold, take the 25 free runs or run offline, switch providers, type-check. - [Add Nola to an existing project](https://nola.sh/docs/start/add-to-existing-project): Retrofit Nola into a project you already have with npm create nola -- --add — what is written, what is merged, what is left alone, and what tsconfig needs. - [Editor setup](https://nola.sh/docs/start/editor-setup): Install the Nola VS Code extension for diagnostics, hover, completion and F5 debugging in .tsi files — and why each line of the launch config matters. - [Project anatomy](https://nola.sh/docs/start/project-anatomy): What every file in a scaffolded Nola project is for — nola.config.ts, the .tsi entry or the .tsi + plain-TS pair, tsconfig, package.json, .env, the ledger. - [The mental model](https://nola.sh/docs/language/mental-model): Learn how Nola uses lazy intents, contextual parameters and ask to bring typed model inference into TypeScript. - [Intents](https://nola.sh/docs/language/intent): Intents describe work that runs when you resolve it. Learn how to create, configure and reuse them, and how they differ from promises. - [infer functions](https://nola.sh/docs/language/infer-functions): Declare an infer function, add instructions and resolve its result. Learn where ask and await are allowed and how to annotate the return type. - [Contextual parameters](https://nola.sh/docs/language/contextual-parameters): Add a leading dot to include a parameter or local binding in model context. Learn which types are supported and how context is shared. - [Context statements](https://nola.sh/docs/language/context-statements): Put text and values in front of the model anywhere in a scope body. Context statements are read at each ask, in source order, and follow JavaScript line rules. - [Extractors](https://nola.sh/docs/language/extractors): Request a typed answer with an extractor. Learn how to write instructions, interpolate values and choose a supported TypeScript type. - [The ask operator](https://nola.sh/docs/language/ask): Resolve extractors, call intents and infer functions with ask. Choose a named model with ask with, and learn when to use await. - [Call intents](https://nola.sh/docs/language/call-intents): Use call intents to infer a function’s arguments in one model request, then run the function and receive its result. - [Tool use](https://nola.sh/docs/language/tool-use): Offer functions to the model with a tool list after the task. It calls them as it needs, Nola runs each call, and the typed answer ends the loop. - [The prompt](https://nola.sh/docs/language/prompt): What Nola sends to the model for an ask — your words inside four utility tags, the schema on the provider's structured output, and how to see it. - [Intent methods](https://nola.sh/docs/language/intent-methods): Configure an intent’s retries, model, parameters and timeout before resolving it. Use detached to control context inheritance. - [Decision types](https://nola.sh/docs/language/decision-types): Use Choice, Scale and Prob for classification with probabilities. Learn their answer shapes, criteria and model requirements. - [TypeScript interop](https://nola.sh/docs/language/typescript-interop): Import Nola functions from TypeScript and TypeScript helpers from Nola. Set up type checking, declarations and cross-file schemas. - [Types as values](https://nola.sh/docs/language/types-as-values): Use exported types as runtime schemas with toJsonSchema, validate and parse. Import the same capabilities from plain TypeScript through .tsi views. - [Restrictions and reserved syntax](https://nola.sh/docs/language/restrictions): Check which syntax Nola reserves, where infer and ask are allowed, and which runtimes can load .tsi files. - [nola.config.ts](https://nola.sh/docs/config/nola-config): Set up nola.config.ts with a model, tracing and runtime options, and learn how the config loads in development, builds and bundlers. - [Models and providers](https://nola.sh/docs/config/providers): Choose a default model, route asks to named models, connect compatible endpoints and use mockProvider for offline tests. - [Resilience — retries, fallback, round-robin](https://nola.sh/docs/config/resilience): Retry failed provider requests, fall back to another model or distribute calls across endpoints. Learn how provider and intent retries differ. - [Ask options — timeouts, params, system message](https://nola.sh/docs/config/ask-options): Configure provider timeouts, set parameters with .withParams(), and add system text to every ask. Includes limits of the built-in providers. - [Environments and secrets](https://nola.sh/docs/config/environments-and-secrets): Manage API keys and settings across development, CI and production, use forceModel in tests, and understand redaction in logs and receipts. - [Telemetry — observers, receipts, tracers](https://nola.sh/docs/config/observability): Send ask events to the terminal, a Nola console or custom observers. Reference event payloads, receipts and tracer settings. - [Record and replay](https://nola.sh/docs/config/record-and-replay): Record model responses in a JSONL ledger and replay them offline for repeatable tests. Learn which changes require a new recording. - [Typed extraction](https://nola.sh/docs/guides/typed-extraction): Pull structured data out of text, step by step — a flat object, nested arrays with JSDoc descriptions, optional fields, and types imported from another file. - [Classification](https://nola.sh/docs/guides/classification): Classify against closed label sets with the TypeScript types you already have — string-literal unions, string enums, inline unions — and add confidence. - [Function calling](https://nola.sh/docs/guides/function-calling): Let the model fill a function's arguments and run it — an async helper, the call intent, the hint form, withRetry idempotency, one round trip for all slots. - [Testing without a network](https://nola.sh/docs/guides/testing): Test Nola code deterministically — mockProvider, forceModel for hermetic CI, node:test or vitest, and record/replay ledgers. - [Error handling](https://nola.sh/docs/guides/error-handling): What fails and how — the built-in correction retry, NolaResolutionError with site and trace, definitive vs retryable errors, and timeouts. - [Types without a model](https://nola.sh/docs/guides/types-without-a-model): Use Nola only for its type values — JSON Schema, validate, parse and Standard Schema from the TypeScript types you have, with no .tsi file and no model. - [Deploying](https://nola.sh/docs/guides/deploying): Ship a Nola app — what nola build emits (dist/src/<name>.tsi.js and a wired nola.config.js), how to run it under plain node, build.target lib, what never ships. - [The nola CLI](https://nola.sh/docs/tooling/cli): Use the Nola CLI to create projects, build and check code, inspect traces, install agent skills, and manage your Nola account. - [The Node loader](https://nola.sh/docs/tooling/node-loader): Run and debug .tsi files without a build step using the Node loader, with source maps, project configuration, and environment variables. - [Bun](https://nola.sh/docs/tooling/bun): Run .tsi from source under Bun with the @nola-lang/bun preload, bundle or compile in one step with Bun.build, and load .tsi modules in bun test. - [VS Code extension](https://nola.sh/docs/tooling/vscode): Install and configure the Nola VS Code extension for diagnostics, completion, TypeScript interop, snippets, and debugging in .tsi files. - [Syntax cheatsheet](https://nola.sh/docs/reference/syntax-cheatsheet): Look up Nola syntax for infer functions, contextual parameters, extractors, ask, call intents, values in an instruction and intent methods. - [Intent API](https://nola.sh/docs/reference/intent-api): Reference the methods on Askable<T> and Intent<T>, the ModelRef and ProviderParams types, and the isIntent runtime guard. - [Providers API](https://nola.sh/docs/reference/providers-api): Reference provider factories, platform options, retries, mocks and record/replay, with an example of a custom chat provider. - [Config schema](https://nola.sh/docs/reference/config-schema): Look up nola.config.ts settings, types, defaults and validation errors, including which options currently affect execution. - [Schema derivation](https://nola.sh/docs/reference/schema-derivation): Learn which TypeScript types Nola can turn into JSON Schema, how JSDoc constraints affect validation, and how unsupported types are handled. - [Error codes](https://nola.sh/docs/reference/error-codes): Find the cause and fix for Nola parse, compile, runtime and bundler errors. Every diagnostic has a stable code and direct link. - [Nola compared](https://nola.sh/docs/compare): Compare how Nola, BAML, LangGraph, and the Vercel AI SDK define typed model calls, manage context, and fit into an application. - [Nola vs BAML](https://nola.sh/docs/compare/baml): Compare typed extraction and a follow-up reply in BAML and Nola, including schema ownership, generated clients, context, and prompt tooling. - [Nola vs LangGraph](https://nola.sh/docs/compare/langgraph): Compare a two-step LangGraph workflow with a Nola function, and see how durable graph orchestration can work alongside typed Nola calls. - [Nola vs Vercel AI SDK](https://nola.sh/docs/compare/vercel-ai-sdk): Compare structured output in the Vercel AI SDK and Nola, including schema definitions, shared context, streaming, and TypeScript integration. - [Examples](https://nola.sh/docs/examples): Browse the runnable Nola examples — extraction, classification, context statements, recursive types, constraints, function calling and an agent loop. - [extract-person](https://nola.sh/docs/examples/extract-person): Extract a typed Person object from text and pass it to a plain TypeScript helper, using a standard NodeNext import inside the Nola module. - [extract-resume](https://nola.sh/docs/examples/extract-resume): Extract resume fields with nested Education arrays and JSDoc descriptions, using TypeScript interfaces to define the expected output. - [classify-message](https://nola.sh/docs/examples/classify-message): Classify messages with string-literal unions, string enums, and inline unions, then use the typed results in ordinary TypeScript. - [triage-ticket](https://nola.sh/docs/examples/triage-ticket): Triage support tickets with the typesafe() provider, mapping literal unions and boolean fields to questions about the ticket text. ## Blog - [Nola 0.1.15: tool use](https://nola.sh/blog/nola-0-1-15/): What's new in Nola 0.1.15: tool use with a list of functions after the task, values inside an ask, Bun support, browser-ready libraries and editor fixes. - [Nola 0.1.14: context statements](https://nola.sh/blog/nola-0-1-14/): What's new in Nola 0.1.14: context statements, colon types for asks, function calls without the dots, a prompt you can read and a new agent-loop starter. ## Source - [GitHub](https://github.com/nola-lang/nola): public source mirror - [npm](https://www.npmjs.com/package/nola-lang): the `nola-lang` CLI - [Discord](https://discord.gg/YmJ3Ew59Gw): community chat