mikehostetler

mikehostetler

Jido - A SDK for Building Autonomous Agent Systems

I’m excited to announce Jido, a framework providing foundational primitives for building autonomous agent systems in Elixir. While developing agent-based architectures, I found existing tools lacked the right abstractions for building truly autonomous systems that could evolve and adapt at runtime.

Core Architecture

Jido’s architecture is built around four core primitives that map directly to key patterns in autonomous systems:

Actions provide a composable unit of work with rich metadata, enabling agents to introspect capabilities and combine them in novel ways at runtime. Unlike traditional functions, Actions include schemas and metadata that support dynamic reasoning and composition.

Workflows extend beyond traditional sequential chains to support dynamic composition patterns. Building on Elixir’s strengths, workflows can be constructed to handle conditional paths, error recovery, and compensation seamlessly.

Agents maintain schema-validated state while planning and executing workflows. Through directives, agents can modify their own capabilities at runtime - such as enqueueing additional instructions to perform.

Sensors operate as independent processes, providing real-time environmental awareness through standardized signals. The exist to support Agents by monitoring external events.

SDK & Extension

Jido is designed as an SDK for building agent-based systems. The core framework provides the runtime primitives, while the companion jido_ai package offers integrations with LLM providers like Anthropic’s Claude through the instructor_ex package. Teams building with Jido can easily integrate any LLM into Jido via a custom Action.

Current Status

Version 1.0.0 provides production-ready implementations of all core primitives. Work is underway on enhanced Agent Server and Supervisor capabilities for 1.1. We’re actively using Jido in production and welcome feedback from teams building autonomous systems.

Resources

We look forward to seeing what the Elixir community builds with Jido!

Thanks!

Most Liked

mikehostetler

mikehostetler

Great question - This whole space is evolving quickly and has been a fantastic mental challenge to shed my old habits of how these apps get built - so this is my current perspective.

The “use an LLM assistant to execute a tool” trend of late benefits one party - LLM API providers. I’ve read over a LOT of repo’s, and have played with a lot of toys.

That’s why this foundational repo has ZERO LLM or AI code in it. At this foundational layer, LLM tool calling as a first class citizen didn’t feel right.

Don’t get me wrong, I wrote this to integrate with LLM’s - but the Elixir way is to build with pure data structures and minimal dependencies on OTP. That’s the purpose of this package.

As a sneak peek - here’s a Jido Action which implements a call to Anthropic Claude using instructor_ex to fetch a “Chat Completion” - aka agent chatting: jido_ai/lib/jido_ai/anthropic.ex at main · agentjido/jido_ai · GitHub

Agents as GenServers is implemented and tested. I’m not entirely happy with the API yet so I didn’t include it in this official release. They each spin up a DynamicSupervisor and can manage delegating tasks to other agents, starting and stopping Signals and doing all sorts of other cool things.

I see a future where we each have thousands of Agents working for us constantly - like a swarm of ants. No other framework or platform comes close to making this happen - so I started from first principles with Elixir.

Enjoy!

EDIT: There will be many examples coming soon to demonstrate the scope of what Agents with Jido are capable of.

11
Post #6
mikehostetler

mikehostetler

Correct - the foundational library can be used without LLM’s. During planning, I felt it was important to simplify down to the base data structures and interaction patterns - get those correct - and then build LLM interaction patterns on top of that.

You can see an initial implementation of a Jido.Action that calls an LLM in the jido_ai package here: https://github.com/agentjido/jido_ai/blob/main/lib/examples/politician.ex

This example uses instructor_ex - but langchain or any other Elixir AI package could easily be integrated for an LLM response.

Yes, exactly - or even Broadway. This problem space of data transformation pipelines has a lot of solutions.

Each solution has it’s strengths. I love and have used each of these tools many times.

Jido won’t be the best at raw throughput as it does not use GenStage - like Broadway or Flow. Jido does not assume a database, if you need a database backed Job Processing system, you should use Oban.

Jido is aimed at the space where a particular agent (or queue?) is built to facilitate a wide variety of output - because a LLM is typically involved. Low throughput, high variety.

Where the Agent space gets crazy-weird is when you let the LLM pick the next action. It’s not random … but it’s not idempotent either. Jido agents natively support a list of “allowed” actions (https://hexdocs.pm/jido/agents.html#creating-your-first-agent) for this reason - it provides a small level of control over this use case.

I purpose built Directives to help provide some control over these advanced use cases.

This space evolves weekly - and I’m constantly learning and evolving my thinking here as well.

mikehostetler

mikehostetler

The primitives share similarities with Oban - but the use-cases are different.

Agent techniques like “Chain of Thought” (Chain-of-Thought Prompting | Prompt Engineering Guide<!-- -->) string together several actions with an LLM’s response deciding which next-action to choose. This simulates human reasoning leading to higher-quality outputs.

Jido was tailored towards these use cases. But, as I explained above, as I worked through my own prompting pipelines, I got annoyed with LLM’s being slow an flaky. When I set out to build Jido, I wanted to ensure the building blocks didn’t make assumptions about LLM’s being involved, but also supported classical AI planning algorithms - a currently neglected sector of artificial intelligence research.

Think about video game NPC’s - the AI used to power them are most often things like Behavior trees or Zipper trees.

Elixir has a solid base of these algorithms available as Hex packages now and there was even a talk at ElixirConf about them in 2018

A lot of the latest AI research focus has gone towards LLM’s lately, but I find algorithms like behavior trees to be more practical in the real-world because they are more reliable in several ways.

Really appreciate the questions here- I’m adding clarifications to the README along the way to hopefully answer some of these questions for others in the future.

mikehostetler

mikehostetler

Nice - I’m a fan of Scala and Akka

The determinism vs. non-determinism when you introduce LLM’s is a challenge. That’s part of the reason why I chose to keep LLM’s out of the Jido foundation - I wanted a clean workspace. That said, a lot of the features in the foundation were built with LLM’s in mind such as validating Agent schema’s and allow-listing Actions that Agents can run.

Your visualization is super cool! I’d definitely welcome a conversation.

I’m finalizing the Jido 1.1 release this week and then will be building loads of demo’s into jido_workbench - a Phoenix instance with Agents hooked into LiveView. It’s my current messy playground - but once the dust settles on the framework it will be fun to add a bunch of demo’s.

This code is stale and has been completely re-written, but it gives you a flavor of what I’m aiming for: jido_workbench/lib/jido_workbench_web/live/jido_live.ex at main · agentjido/jido_workbench · GitHub

mikehostetler

mikehostetler

Is there any support for parallelism in Jido?

Nothing explicit other than Jido.Exec having both a run/4 and run_async/4 methods.

The vision is to utilize existing OTP patterns for any concurrency. I’m working on publishing a Roadmap - but here’s the gist:

  • DONE - Stateless Agents
    • This is the foundation of Agents as data structures only with Jido.Exec focused on safely executing a single Action at a time
  • 98% DONE - Stateful Agents
    • This milestone wraps a GenServer around the Stateless Agent and adds the Jido.Signal as the foundation for inter-process communication
    • No parallelization at this layer other then cast/2 to call an Agent with a Signal, receive a ref and wait for the Agent to send you the result of the Action - but this is more async then parallel
  • 50% - Orchestrated Agents
    • This is what I’ve been working on the last few weeks and is the mode where a lead agent orchestrates child agents towards accomplishing its objective
    • The centerpiece of this layer is a runtime-based workflow orchestrator that coordinates and optimizes multi-agent signals in parallel - no explicit parallel coordination will be required - you get it for free
    • You can see some of the brainstorming here: https://x.com/mikehostetler/status/1906504395795161178

After orchestrated agents are done, there will be plenty of work building out extras and examples.

In Jido’s current state, I would create an Action that wraps Jido.Exec.run_async calls to the 3 actions you want to run in parallel - then await the results of all three before returning itself.

Here’s a quick gist that Claude built for me to model this: Parallel Jido Actions · GitHub

Let me know if that works for you and I’ll whip up a guide for this and throw together a Livebook to put into the Workbench cookbook permanently.

Good luck!

Where Next?

Popular in Libraries Top

New
mhanberg
I just released the first version of Temple: an HTML DSL for Elixir and Phoenix! You can read this blog post or the docs for more info...
New
cjen07
parameterized pipe in elixir: |n&gt; edit: negative index in |n&gt; and mixed usage with |&gt; are supported example: use ParamP...
New
markmark206
simple_feature_flags is a tiny package that lets you turn features on or off based on which environment (e.g. localhost, staging, product...
New
mcrumm
If you would like to migrate away from node/npm/webpack while still using sass, the dart_sass package provides a installer and runner for...
New
hpopp
After just over two years in development, this latest version of Pigeon is what I finally consider done in regards to my original vision ...
New
mathieuprog
Hello :wave: Allow me to introduce you to Tz, an alternative time zone database support to Tzdata. Why another library? First and fore...
New
sasajuric
I’d like to announce a small library called boundaries. This is an experimental project which explores the idea of enforcing boundaries ...
New
KronicDeth
Elixir plugin for JetBrain’s IntelliJ Platform (including Rubymine) This is a plugin that adds support for Elixir to JetBrains IntelliJ...
289 35421 110
New
michalmuskala
Hello everybody. I have just released Jason - a new JSON library. You might be wondering, why do we need a new library? The primary foc...
New

Other popular topics Top

stefanchrobot
What’s the safe way to decode a JSON string into a struct? I want to avoid calling String.to_atom. Jason.decode can give me a map with st...
New
freewebwithme
Using vs code and installed ElixirLS: support and debugger. And I got an error popped up on start up says Failed to run ‘elixir’ comma...
New
jononomo
I am trying to figure out how Mix knows whether the environment is test, dev, or prod -- where is this set? Thanks.
New
dotdotdotPaul
Okay, I'm having a heck of a time trying to figure out how to best handle the validation of belongs_to associations in Ecto. I'm sure I'...
New
albydarned
Hello all! I am typing this post from my new MacBook Pro with the M1 chip. I’m loving it so far, and will probably use it as my daily dr...
New
aalberti333
As the title describes, I’m trying to run Enum.map() over a list of key/value pairs, where the value is a map. My data looks like this: ...
New
mgjohns61585
Could someone help me? I'm making my first elixir program, number guessing game. I can't figure out how to convert the user's guess from ...
New
alice
Hey, Just curious what are the main benefits of Elixir compared to Clojure? When is Elixir more useful than Clojure and vice versa? Th...
New
qwerescape
Is there a way to get the call stack or stack trace at any point in the code? Not from exceptions, but an expression that returns how the...
New
WestKeys
Currently suffering from paralysis by [HTTP client] analysis. This is rather unusual in Elixirland as there tends to be consensus on the ...
New

Sub Categories:

We're in Beta

About us Mission Statement