Skip to content
Merged
Changes from 1 commit
Commits
Show all changes
65 commits
Select commit Hold shift + click to select a range
b5b4bd8
start change to 0.18
danstarns May 31, 2025
15854a5
docs: *
danstarns May 31, 2025
be03811
docs: *
danstarns May 31, 2025
408a1bb
*
danstarns May 31, 2025
fc64e81
*
danstarns May 31, 2025
f61d817
*
danstarns May 31, 2025
0bb775e
*
danstarns May 31, 2025
0093917
*
danstarns May 31, 2025
38f1bda
*
danstarns May 31, 2025
03d662b
*
danstarns May 31, 2025
c2845f7
*
danstarns May 31, 2025
470e7ef
*
danstarns May 31, 2025
464beb5
*
danstarns Jun 1, 2025
45aed7e
*
danstarns Jun 1, 2025
917895b
*
danstarns Jun 1, 2025
034647c
*
danstarns Jun 1, 2025
6c9f9aa
*
danstarns Jun 1, 2025
81dfcae
*
danstarns Jun 1, 2025
63aa643
*
danstarns Jun 1, 2025
9a033a2
*
danstarns Jun 1, 2025
0ae3b1d
*
danstarns Jun 1, 2025
df84851
*
danstarns Jun 1, 2025
f28cfbf
*
danstarns Jun 1, 2025
76a15b1
*
danstarns Jun 1, 2025
c17dd9a
*
danstarns Jun 1, 2025
6096c35
*
danstarns Jun 1, 2025
9eca063
*
danstarns Jun 1, 2025
5008dee
Merge branch 'main' into v-0-18
ryanfoxtyler Jun 1, 2025
4383701
*
danstarns Jun 1, 2025
7014c9c
*
danstarns Jun 1, 2025
ad0f0f0
*
danstarns Jun 1, 2025
309ae6a
*
danstarns Jun 1, 2025
0cfa1b3
Merge branch 'main' into v-0-18
danstarns Jun 1, 2025
254bb25
*
danstarns Jun 1, 2025
4510440
*
danstarns Jun 1, 2025
50c6fe2
*
danstarns Jun 1, 2025
3b77519
*
danstarns Jun 2, 2025
4f0ac23
*
danstarns Jun 2, 2025
d31a3b9
*
danstarns Jun 2, 2025
052a68e
add events to agents
danstarns Jun 4, 2025
78c75ea
*
danstarns Jun 4, 2025
750371c
*
danstarns Jun 4, 2025
b313d1e
*
danstarns Jun 4, 2025
f42b2b1
Merge branch 'main' into v-0-18
danstarns Jun 5, 2025
5eb42ef
add note about the rest of agent fields
danstarns Jun 5, 2025
53716f4
use any over map interface
danstarns Jun 5, 2025
7d0e758
use accumulatedReports over context
danstarns Jun 5, 2025
3532626
more error handling
danstarns Jun 5, 2025
9dc80b3
pass non null data around
danstarns Jun 5, 2025
2356e84
remove repeated workflow list
danstarns Jun 5, 2025
0ee3fbc
*
danstarns Jun 5, 2025
76ef44a
*
danstarns Jun 5, 2025
3838fcd
*
danstarns Jun 5, 2025
2e05764
sync to support sub https://github.com/hypermodeinc/modus/pull/875
danstarns Jun 8, 2025
98dcd7a
*
danstarns Jun 8, 2025
8380ff4
Merge branch 'main' into v-0-18
danstarns Jun 10, 2025
54b5b1e
Merge branch 'main' into v-0-18
danstarns Jun 12, 2025
b68335e
add start stop based on https://github.com/hypermodeinc/modus/pull/889
danstarns Jun 12, 2025
77b09fb
Merge branch 'main' into v-0-18
danstarns Jun 14, 2025
5f78435
Merge branch 'main' into v-0-18
danstarns Jun 17, 2025
5e1e7b1
trunk...
danstarns Jun 17, 2025
312e1bc
updates first modus agent
danstarns Jun 17, 2025
879bd46
*
danstarns Jun 17, 2025
d410cda
*
danstarns Jun 17, 2025
251f2df
Merge branch 'main' into v-0-18
johnymontana Jun 24, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 28 additions & 25 deletions modus/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,37 +8,39 @@ sidebarTitle: "Overview"

## What is Modus? {/* vale Google.Contractions = NO */}

Modus is an open source, serverless framework for building functions and APIs,
powered by WebAssembly.
Modus is an open source, serverless framework for building intelligent agents
and APIs in Go or AssemblyScript (a TypeScript-like language). Modus is a
runtime purpose-built for orchestrating autonomous AI agents that operate as
first-class citizens in your stack.

You write your app logic in Go or AssemblyScript, and Modus provides additional
features to easily integrate models, data, and external services.
You write your app logic in Go or AssemblyScript—whichever you prefer—and Modus
compiles everything to WebAssembly for fast performance at scale and at the
edge. Each agent instance gets a dedicated execution environment, sand-boxed for
resiliency, scalability, and security.

To **build apps that are thoughtful, fun, and effective**, we often need to
integrate models in different forms, whether generative large language models or
classical machine/deep learning models.
Modus enables both stateless functions for quick API responses and stateful
agents that maintain persistent memory across interactions. This eliminates the
need to parse conversation histories, rebuild context from scratch, or lose
state when errors occur.

Your app might be a simple create, read, update, and delete (CRUD) function that
has a single model to identify similar entries. Or, it could be a complex
agentic reasoning system that chains dozens of models and data sources together.
**Modus creates a way of working with models that scales with your needs.**
You can run Modus locally for development or deploy it in seconds to Hypermode
for production.

Modus exists to make it easier for you to build the apps of your dreams.
## What is Modus good for? {/* vale Google.Contractions = NO */}

<Note>
Modus is a multi-language framework. It currently includes support for Go and
AssemblyScript, a WebAssembly compatible TypeScript-like language. Additional
language support is in development.
</Note>
Modus is designed for building both traditional functions and intelligent
agents. It supports sub-second response times for stateless operations and
long-running, autonomous workflows that maintain state over time.

## What is Modus good for? {/* vale Google.Contractions = NO */}
**Functions**: stateless operations for API endpoints, data processing, and AI
inference tasks.

We designed Modus primarily as a general-purpose app framework, it just happens
to treat models as a first-class component. With Modus you can use models, as
appropriate, without additional complexity.
**Agents**: stateful entities that maintain conversation history, coordinate
between models and tools, and operate independently over extended periods.
Agents automatically handle state persistence and fault tolerance.

However, Modus is best for apps that require sub-second response times. We've
made trade-offs to optimize for speed and simplicity.
Both can be deployed in the same app, allowing you to choose the right
abstraction for each use case.

For more inspiration, check out the
[Modus recipes](https://github.com/hypermodeinc/modus-recipes).
Expand All @@ -49,9 +51,10 @@ A few of the core Modus features include:

| Feature | Description |
| ------------------------------------------- | -------------------------------------------------------------------------------------------- |
| [Multi-Language](/modus/project-structure) | Write functions in Go and AssemblyScript, with additional language support in development |
| **Agent Runtime** | Deploy autonomous agents as actors with dedicated execution environments and fault isolation |
| [Multi-Language](/modus/project-structure) | Write functions and agents in Go or AssemblyScript, compiled to WebAssembly for performance |
| [Auto-Generated API](/modus/api-generation) | A secure API is automatically generated from your function signatures |
| [Model Integration](/modus/model-invoking) | Connect and invoke AI models from different providers, without learning a new SDK |
| [Search](/modus/search) | Add natural language search and recommendations with integrated vector embeddings |
| [Authentication](/modus/authentication) | Secure your API endpoints with minimal configuration |
| **WebAssembly Runtime** | Small and portable execution engine for deployment across server, edge, and desktop computes |
| **WebAssembly Runtime** | Portable execution engine delivering fast performance at scale and at the edge |