Skip to content

About

The official docs for the BoxLang Programming Language

Topics

Resources

Stars

5 stars

Watchers

10 watching

Forks

Repository files navigation

description BoxLang is the software productivity platform for building, modernizing and running applications, with developers and AI agents working together.
icon house-window

Introduction

🚀 The Software Productivity Platform

BoxLang is the software productivity platform for building, modernizing and running applications, with developers and AI agents working together.

  • Built for developers. A modern, expressive, dynamic JVM language with a batteries-included runtime.
  • Built for AI. Predictable conventions, agent skills, live runtime introspection over MCP, and a first-class AI framework.
  • Built to ship. One runtime for the CLI, web servers, containers, serverless, desktop and more. Backed by professional support when you need it.

BoxLang Multi-Runtime

{% content-ref url="getting-started/overview/" %} overview {% endcontent-ref %}

🧱 Five Pillars

Pillar What you get
⚡ Productivity Low ceremony syntax, fluent APIs, and built-in file handling, HTTP, JDBC, async, caching, scheduling, templating and more. Less glue code and less to install.
🔐 Security Configurable runtime security, and modules for JWT, ESAPI, CSRF, LDAP and cloud secrets managers.
🏛️ Governance Control what runs and who can call it. Access-controlled MCP tooling for your runtime, and AI guardrails, human approval and audit trails for agents.
📦 Deployment Run it on the OS, CommandBox, MiniServer, Docker, AWS Lambda, Azure Functions, Google Cloud Functions, Spring Boot, WebAssembly and more. Compile to bytecode.
🤖 AI BoxLang AI: chat, agents, tools, memory, RAG and MCP through one fluent API, across many providers including OpenAI, Claude, Gemini, Bedrock and local models.

🤖 The Easiest Platform for Agents to Build On

AI agents are most productive on platforms that are predictable, well documented and complete. BoxLang is designed that way:

  • One runtime, few moving parts. Files, HTTP, databases, async, caching, scheduling, logging and AI ship with the platform, so agents do not have to choose and wire up dozens of libraries.
  • Conventions agents can follow. Consistent project layouts, Application.bx lifecycle, modules and configuration.
  • Skills and guidelines. Installable SKILL.md playbooks teach your agent how to do specific BoxLang tasks the idiomatic way. Browse them at skills.boxlang.io and install the BoxLang developer set with npx skills add ortus-boxlang/skills/boxlang-developer.
  • Fast validation. boxlang check validates syntax without running code, so agents can verify every edit.
  • Docs over MCP. The BoxLang documentation is available as an MCP server at https://boxlang.ortusbooks.com/~gitbook/mcp, so agents read current docs instead of guessing.
  • Live runtime introspection. With BoxLang+, the bx-mcp module lets an agent inspect a running server through MCP, with access control built in.
  • Java under the hood. 100% Java interoperability gives agents the entire JVM ecosystem when they need it.

{% content-ref url="getting-started/agentic-development/" %} agentic-development {% endcontent-ref %}

flowchart LR
    Dev[Developer] --> Agent[AI Agent]
    Agent --> Skills[Skills and Guidelines]
    Agent --> Docs[Docs MCP]
    Agent --> Code[BoxLang Code]
    Code --> Runtime[BoxLang Runtime]
    Runtime --> MCP[bx-mcp Live Introspection]
    MCP --> Agent
    Runtime --> Ship[CLI, Web, Cloud, Containers]
Loading

🏢 And Ready for the Enterprise

BoxLang is professional open source, built and supported by Ortus Solutions. Start free, then add support and productivity as you grow:

  • Professional support with SLAs, plus dedicated engineer options.
  • Premium modules for spreadsheets, CSV, Redis, Couchbase, cloud secrets, LDAP, MCP and more.
  • Modernization path. Run existing Adobe ColdFusion and Lucee CFML applications on BoxLang with the bx-compat-cfml module, with no code changes, then modernize at your own pace.
  • Predictable roadmap and enhanced or custom builds.

{% hint style="success" %} Try every BoxLang+ module free for 60 days. There is nothing to sign up for. The trial starts automatically the first time you start a BoxLang server or CLI with a BoxLang+ module installed, so you can test whether your idea, update or migration works with no friction. Most modules are open source and free to use. If you want enterprise support and the full productivity stack, join us. {% endhint %}

{% content-ref url="boxlang-framework/boxlang-plus/" %} boxlang-plus {% endcontent-ref %}

{% embed url="https://www.boxlang.io/plans" %}

⚡ Quick Start

Install BoxLang on Mac or Linux:

/bin/bash -c "$(curl -fsSL https://install.boxlang.io)"

Verify and start the REPL:

boxlang --version
boxlang

Serve a web application:

boxlang-miniserver --port 8080

Add modules, including BoxLang+ modules that start their 60-day trial automatically:

install-bx-module bx-plus bx-ai bx-mcp

See the installation guide for Windows, Homebrew, BVM and other options.

🧭 Where to Go Next

  • 🤖 Agentic Development - set up your project, skills, MCP servers and IDE for AI agents.
  • 📘 Overview - what BoxLang is and how it is put together.
  • 🛠️ Installation and Running BoxLang - every runtime and deployment target.
  • 🔁 Running CFML Apps - modernize Adobe ColdFusion and Lucee applications.
  • 🧠 BoxLang AI - chat, agents, tools, memory, RAG, MCP and enterprise governance.
  • 🧩 Modules - the extension ecosystem.
  • 🎓 BoxLings - learn BoxLang hands-on with an interactive CLI and test-driven exercises.

📜 License

BoxLang is open source and licensed under the Apache 2 License. Copyright and Registered Trademark by Ortus Solutions, Corp.

💬 Discussions & Help

To support open source, consider becoming a patron at patreon.com/ortussolutions.

🐞 Reporting a Bug

We all make mistakes from time to time, so why not let us know about it and help us out? We also love pull requests, so please star us and fork us at github.com/ortus-boxlang/boxlang.

Jira Issue Tracking

🔗 Resources

Ortus Solutions, Corp

This book was written and maintained by Luis Majano and the Ortus Solutions Development Team.

Ortus Solutions is a company that focuses on building professional open source tools, custom applications and great websites! We're the team behind ColdBox, the de-facto enterprise BoxLang HMVC Platform, TestBox, the BoxLang Testing and Behavior Driven Development (BDD) Framework, ContentBox, a highly modular and scalable Content Management System, CommandBox, the BoxLang CLI, package manager, etc, and many more - https://www.ortussolutions.com/

About

The official docs for the BoxLang Programming Language

Topics

Resources

Stars

5 stars

Watchers

10 watching

Forks

Releases

Packages

Used by

Contributors

Languages