AgentLang Programming Language

AgentLang is the easiest way to build AI Agents, Chatbots and Apps - build teams of AI agents that collaborate (with other AI agents and humans) to handle complex, time-consuming, monotonous tasks. AgentLang is a data-oriented, declarative abstraction for building agents and apps, similar to how Terraform is a declarative abstraction for infrastructure-as-code.

Open | Enterprise-grade | Production-ready

The AgentLang language specification, its compiler and runtime are open source. AgentLang programs can run anywhere - avoiding the vendor lock-in of other AI agent/programming platforms.

AgentLang runtime has native integration with databases, vector databases, auth stores, etc. AgentLang programs run on the JVM and can make use of any of the thousands of existing Node and other JavaScript libraries out there.

AgentLang comes with all the modern tooling, dependency management and REPL needed to build production-grade agents and apps.

First-class AI Agents

Agents are a built-in language construct - developers can choose from one of the built-in agent-types, or easily add their own agent-types.

Runtime Support

AgentLang supports both Node.js and Deno runtimes for development and execution.

Prerequisites

• Node.js 20+ (CI runs on 20.x, local development often uses 24.x)
  • Note: Some functions may behave differently between versions (e.g., array methods on iterators)
• Deno 1.35.0 or later (optional, for Deno-based workflows)

Common Development Commands

AgentLang provides npm scripts for common tasks. Here are the most frequently used commands:

# Install dependencies
npm install

# Build the project
npm run build

# Generate Agentlang parser
npm run langium:generate

# Run tests
npm test

# Interactive REPL with specific app.json
npm run repl -- --app example/erp/app.json
# To exit REPL: use close() or Ctrl+C or Ctrl+D, then press Ctrl+C again to fully exit

# Run TypeScript files with specific app.json
npm run run -- --app example/blog/app.json path/to/file.ts

# Development server
npm run dev

Using Deno

When working with Deno, use these npm scripts:

# Build with Deno
npm run build:deno

# Watch mode with Deno
npm run watch:deno

# Run tests with Deno
npm run test:deno

Build instructions

Make sure you have a working Node environment with version 20 or higher (CI runs on 20.x, while local development often uses 24.x).

Install dependencies:

npm install

Generate the Agentlang parser and build the project:

npm run langium:generate
npm run build
npm test

Test with sample app.json files:

# Parse and validate an AgentLang file
node ./bin/cli.js parseAndValidate example/blog/blog.al

# Run a specific app
node ./bin/cli.js run example/blog

Linting and Code Style

AgentLang uses ESLint and Prettier to maintain code quality. Run the following commands to check and fix linting issues:

# Run ESLint
npm run lint

# Fix ESLint issues automatically
npm run lint -- --fix

# Format code with Prettier
npm run format

The project is currently in the process of adopting stricter TypeScript standards. The ESLint configuration currently allows the use of any types and certain deprecated type constructors, but these will be gradually phased out in future releases.