LibreAI / AI Agents / julep
// agents · julep-ai/julep

julep

Durable, composable AI agents — flows that crash and resume, retry safely, and explain every step.

★ 6.6k stars⑂ 968 forksApache-2.0updated 2026-08
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

julep is an open-source ai agents project by julep-ai (julep-ai/julep on GitHub). It has 6,577 GitHub stars and 968 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 6 August 2026.

Repository
julep-ai/julep
GitHub stars
6,577
Forks
968
License
Apache-2.0
Last updated on GitHub
6 August 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your workflow

    Sketch the multi-step agent flow you need — the tools it may call, the decisions it must make, and where it must be able to resume after a failure.

  2. Get the package

    Install the julep Python package (the current release line is pre-release, so use the documented --pre flag).

  3. Configure tools and secrets

    Register your tools or MCP servers and keep production secrets in your deployment environment or Kubernetes Secrets, as the docs require.

  4. Run your first flow

    Define a @flow, dry-run it locally with in-memory tools, then deploy it and watch each step execute.

// features

Why people love it

Durable, resumable flows

Flows are built to crash and resume and to retry safely, so long-running agent work is not lost when a process dies.

Composable @flow definitions

Define flows in Python: registered tools and pure functions, think/cond/switch/each/reschedule steps, and record merging with the | operator.

Explainable execution

Every step of a flow is recorded so you can see what the agent did and why, rather than getting an opaque final answer.

MCP tool support

Call MCP servers from inside a flow with mcp_tool(server, tool), alongside natively registered tools.

CLI for plan and apply

The julep CLI supports plan, apply and status with composable selectors (tags, state, graph traversal) across environments.

Local dry runs

dry_run executes a flow locally with in-memory tools and deterministic fake reasoners, so you can test logic before deploying.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone Julep to explore the source, examples and docs.

    git clone https://github.com/julep-ai/julep.git
    cd julep
  2. Install the SDK

    Install the current Julep Python package from PyPI.

    pip install --pre julep
  3. Try an example flow

    Run one of the bundled @flow examples locally to see a durable flow execute step by step.

    python examples/episode_summary_flow.py # see README for the exact command
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Julep?

julep-ai maintains Julep; documentation is published at docs.julep.ai.

Is Julep free?

The open-source project is licensed under Apache-2.0. Julep also offers a hosted platform, but the repository code itself is free to use under that license.

Does it need a paid API key?

Flows call LLMs through reasoners, so in production you typically supply your own model provider credentials; local dry runs can use deterministic fake reasoners instead.

How does it compare to LangGraph?

Both build graph-like agent workflows. Julep emphasizes durable execution — crash-and-resume flows, safe retries and step-by-step explanations — managed through its CLI and deployment model.

How do I get started?

pip install --pre julep, then work through the Quickstart and the example flows in the examples directory.

// keep exploring

Similar tools

AI Agents

smolvm

An embeddable, portable, branchable microVM that runs AI agents safely on your own machine.

★ 6.6k starsApache-2.0
View guide →
AI Agents

loopx

A control plane with a durable state kernel that keeps long-horizon agents moving across sessions.

★ 6.2k starsApache-2.0
View guide →
Agents

workflow

Vercel’s SDK for durable, reliable, observable apps and AI agents in TypeScript.

★ 2.4k starsApache-2.0
View guide →
AI Agents

yao

All your agents and workspaces in one place — on every device you own.

★ 8.1k starsNOASSERTION
View guide →
AI Agents

OpenSandbox

A secure, fast sandbox runtime where AI agents can execute safely.

★ 15.7k starsApache-2.0
View guide →
AI Agents

claude-mem

Give your coding agents a persistent memory that survives every session.

★ 97.9k starsApache-2.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if julep is not the right fit.

Get julep

Free and open — grab the source, star the repo, and start creating.