Please enter a brief description here
npm install agentlang2AgentLang 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.


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.
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.
AgentLang supports both Node.js and Deno runtimes for development and execution.
- 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)
AgentLang provides npm scripts for common tasks. Here are the most frequently used commands:
``shellInstall dependencies
npm install
Using Deno
When working with Deno, use these npm scripts:
`shell
Build with Deno
npm run build:denoWatch mode with Deno
npm run watch:denoRun 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:
`shell
npm install
`Generate the Agentlang parser and build the project:
`shell
npm run langium:generate
npm run build
npm test
`Test with sample app.json files:
`shell
Parse and validate an AgentLang file
node ./bin/cli.js parseAndValidate example/blog/blog.alRun 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:
`shell
Run ESLint
npm run lintFix ESLint issues automatically
npm run lint -- --fixFormat 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.