# Julep — Stateful AI Agent Platform with Workflows

> Build persistent AI agents with multi-step workflows, long-term memory, and tool integrations. Julep handles state management so agents remember across sessions.

## Install

Copy the content below into your project:

## Quick Use

```bash
pip install julep
```

```python
from julep import Julep

client = Julep(api_key="your-key")

# Create a persistent agent
agent = client.agents.create(
    name="Research Assistant",
    model="claude-sonnet-4-20250514",
    about="Helps with research tasks and remembers context across sessions.",
)

# Chat with memory
session = client.sessions.create(agent_id=agent.id)
response = client.sessions.chat(
    session_id=session.id,
    messages=[{"role": "user", "content": "Research quantum computing trends"}],
)
print(response.choices[0].message.content)
```

## What is Julep?

Julep is a platform for building AI agents with persistent state, multi-step workflows, and long-term memory. Unlike stateless LLM calls, Julep agents maintain context across sessions, execute complex multi-step tasks, and integrate with 100+ external tools — all managed server-side.

**Answer-Ready**: Julep is a stateful AI agent platform with multi-step workflows, long-term memory, and 100+ tool integrations. Agents persist across sessions with server-side state management. Works with Claude, GPT, and Gemini models.

**Best for**: Developers building persistent AI agents that need memory and multi-step workflows. **Works with**: Claude, GPT-4o, Gemini, Llama. **Setup time**: Under 5 minutes.

## Core Features

### 1. Multi-Step Workflows

```yaml
# Define complex workflows in YAML
name: research_and_report
steps:
  - tool: web_search
    arguments:
      query: "{{topic}} latest developments 2026"

  - prompt: |
      Summarize these search results into key findings:
      {{_.output}}

  - tool: send_email
    arguments:
      to: "{{user_email}}"
      subject: "Research Report: {{topic}}"
      body: "{{_.output}}"
```

### 2. Long-Term Memory

```python
# Memories persist across sessions
session1 = client.sessions.create(agent_id=agent.id)
client.sessions.chat(session1.id, messages=[
    {"role": "user", "content": "My name is Alice and I work on payments"}
])

# New session, agent remembers
session2 = client.sessions.create(agent_id=agent.id)
response = client.sessions.chat(session2.id, messages=[
    {"role": "user", "content": "What do you know about me?"}
])
# "You're Alice and you work on payments"
```

### 3. Document Storage

```python
# Upload documents for RAG
client.agents.docs.create(
    agent_id=agent.id,
    title="Company Handbook",
    content="...",
    metadata={"type": "policy", "year": 2026},
)

# Agent searches docs during conversation
```

### 4. Tool Integrations
100+ built-in integrations:

| Category | Tools |
|----------|-------|
| Search | Brave, Google, Wikipedia |
| Communication | Email, Slack, Discord |
| Data | SQL, S3, Google Sheets |
| Code | Python execution, GitHub |
| Browser | Web scraping, screenshots |

### 5. Parallel Execution

```yaml
steps:
  - parallel:
    - tool: web_search
      arguments: { query: "topic A" }
    - tool: web_search
      arguments: { query: "topic B" }
    - tool: web_search
      arguments: { query: "topic C" }

  - prompt: "Compare findings: {{_.output}}"
```

## Architecture

```
Client SDK → Julep API Server
                ↓
         ┌──────┴──────┐
         │  State Mgmt  │  ← Sessions, memory, documents
         │  Workflow     │  ← Multi-step task execution
         │  Tool Router  │  ← 100+ integrations
         │  LLM Router   │  ← Claude, GPT, Gemini
         └──────────────┘
```

## FAQ

**Q: Is Julep open source?**
A: The SDK and API specs are open-source. The platform is available as a managed service.

**Q: How does memory work?**
A: Julep automatically extracts and stores relevant facts from conversations, searchable across sessions.

**Q: Can I self-host?**
A: Self-hosting is available for enterprise plans.

## Source & Thanks

> Created by [Julep AI](https://github.com/julep-ai). Licensed under Apache 2.0.
>
> [julep-ai/julep](https://github.com/julep-ai/julep) — 5k+ stars

<!-- ZH -->

## 快速使用

```bash
pip install julep
```

创建持久代理，跨会话保持记忆和上下文。

## 什么是 Julep？

Julep 是有状态 AI 代理平台，支持多步工作流、长期记忆和 100+ 工具集成。代理跨会话保持上下文。

**一句话总结**：有状态 AI 代理平台，多步工作流、长期记忆、100+ 工具集成，代理跨会话保持上下文。

**适合人群**：构建需要记忆和多步工作流的持久 AI 代理的开发者。

## 核心功能

### 1. 多步工作流
YAML 定义复杂任务流程，支持并行执行。

### 2. 长期记忆
自动提取对话中的关键事实，跨会话持久化。

### 3. 文档存储
上传文档，代理在对话中自动检索。

### 4. 100+ 工具集成
搜索、邮件、数据库、代码执行等开箱即用。

## 常见问题

**Q: 开源吗？**
A: SDK 开源，平台提供托管服务。

**Q: 记忆如何工作？**
A: 自动从对话中提取事实，跨会话可搜索。

## 来源与致谢

> [julep-ai/julep](https://github.com/julep-ai/julep) — 5k+ stars, Apache 2.0

---
Source: https://tokrepo.com/en/workflows/dd60ff3f-8a0e-445b-9de7-d8594ad39fb8
Author: Agent Toolkit