README
ΒΆ
Eino Examples
English | δΈζ
Overview
This repository contains examples and demonstrations for using the Eino framework. It provides practical examples to help developers better understand and utilize Eino's features.
Repository Structure
π¦ ADK (Agent Development Kit)
| Directory | Name | Description |
|---|---|---|
| adk/helloworld | Hello World Agent | The simplest Agent example, showing how to create a basic conversational Agent |
| adk/intro/chatmodel | ChatModel Agent | Demonstrates using ChatModelAgent with Interrupt mechanism |
| adk/intro/custom | Custom Agent | Shows how to implement a custom Agent conforming to ADK definition |
| adk/intro/workflow | Workflow Agents | Loop, Parallel, and Sequential Agent patterns |
| adk/intro/session | Session Management | Passing data and state across Agents using Session |
| adk/intro/transfer | Agent Transfer | ChatModelAgent's Transfer capability for task handoff between Agents |
| adk/intro/http-sse-service | HTTP SSE Service | Exposing ADK Runner as an HTTP service with Server-Sent Events |
| adk/human-in-the-loop | Human-in-the-Loop | 8 examples: Approval, Review-Edit, Feedback Loop, Follow-up, Supervisor patterns |
| adk/multiagent | Multi-Agent | Supervisor, Plan-Execute-Replan, Deep Agents, Excel Agent examples |
| adk/common/tool/graphtool | GraphTool | Wrapping Graph/Chain/Workflow as Agent tools |
π Compose (Orchestration)
| Directory | Name | Description |
|---|---|---|
| compose/chain | Chain | Sequential orchestration with compose.Chain, including Prompt + ChatModel |
| compose/graph | Graph | Graph orchestration examples: state graph, tool call agent, async nodes, interrupt |
| compose/workflow | Workflow | Workflow examples: field mapping, data-only, control-only, static values, streaming |
| compose/batch | BatchNode | Batch processing component with concurrency control and interrupt/resume support |
π Flow
| Directory | Name | Description |
|---|---|---|
| flow/agent/react | ReAct Agent | ReAct Agent with memory, dynamic options, unknown tool handler |
| flow/agent/multiagent | Multi-Agent | Host multi-agent (Journal Assistant), Plan-Execute patterns |
| flow/agent/manus | Manus Agent | Manus Agent implementation inspired by OpenManus |
| flow/agent/deer-go | Deer-Go | Go implementation based on deer-flow, supporting research team collaboration |
𧩠Components
| Directory | Name | Description |
|---|---|---|
| components/model | Model | A/B test routing, HTTP transport logging with cURL-style output |
| components/retriever | Retriever | Multi-query retriever, router retriever |
| components/tool | Tool | JSON Schema tools, MCP tools, middlewares (error remover, JSON fix) |
| components/document | Document | Custom parser, extension parser, text parser |
| components/prompt | Prompt | Chat prompt template examples |
| components/lambda | Lambda | Lambda function component examples |
π QuickStart
| Directory | Name | Description |
|---|---|---|
| quickstart/chat | Chat QuickStart | Basic LLM chat example with template, generate, and streaming |
| quickstart/eino_assistant | Eino Assistant | Complete RAG application with knowledge indexing, Agent service, and Web UI |
| quickstart/todoagent | Todo Agent | Simple Todo management Agent example |
π οΈ DevOps
| Directory | Name | Description |
|---|---|---|
| devops/debug | Debug Tools | Eino debugging features for Chain and Graph |
| devops/visualize | Visualization | Rendering Graph/Chain/Workflow as Mermaid diagrams |
Documentation
For detailed documentation of each example, see COOKBOOK.md.
Related Resources
- Eino Framework: https://github.com/cloudwego/eino
- Eino Extensions: https://github.com/cloudwego/eino-ext
- Official Documentation: https://www.cloudwego.io/docs/eino/
Security
If you discover a potential security issue in this project, or think you may have discovered a security issue, we ask that you notify Bytedance Security via our security center or vulnerability reporting email.
Please do not create a public GitHub issue.
License
This project is licensed under the Apache-2.0 License.
Directories
ΒΆ
| Path | Synopsis |
|---|---|
|
adk
|
|
|
helloworld
command
|
|
|
human-in-the-loop/1_approval
command
|
|
|
human-in-the-loop/4_follow-up
command
|
|
|
human-in-the-loop/5_supervisor
command
|
|
|
human-in-the-loop/7_deep-agents
command
|
|
|
intro/agent_with_summarization
command
|
|
|
intro/chatmodel
command
|
|
|
intro/session
command
|
|
|
intro/transfer
command
|
|
|
intro/workflow/loop
command
|
|
|
intro/workflow/parallel
command
|
|
|
intro/workflow/sequential
command
|
|
|
multiagent/deep
command
|
|
|
multiagent/layered-supervisor
command
|
|
|
multiagent/plan-execute-replan
command
|
|
|
multiagent/supervisor
command
|
|
|
intro/http-sse-service
module
|
|
|
components
|
|
|
document/parser/customparser
command
|
|
|
document/parser/extparser
command
|
|
|
document/parser/textparser
command
|
|
|
model/abtest/example
command
|
|
|
model/httptransport
Package httptransport provides a configurable cURL-style logging RoundTripper for HTTP-based ChatModel clients.
|
Package httptransport provides a configurable cURL-style logging RoundTripper for HTTP-based ChatModel clients. |
|
prompt/chat_prompt
command
|
|
|
retriever/multiquery
command
|
|
|
retriever/router
command
|
|
|
tool/jsonschema
command
|
|
|
tool/mcptool/callresulthandler
command
|
|
|
tool/middlewares/jsonfix
Package jsonfix provides a ToolMiddleware for Eino's ToolsNode that repairs malformed JSON arguments produced by LLMs before tool execution.
|
Package jsonfix provides a ToolMiddleware for Eino's ToolsNode that repairs malformed JSON arguments produced by LLMs before tool execution. |
|
tool/middlewares/jsonfix/example
command
This example shows how to configure the jsonfix middleware on a ToolsNode to repair invalid JSON arguments before invoking a local tool.
|
This example shows how to configure the jsonfix middleware on a ToolsNode to repair invalid JSON arguments before invoking a local tool. |
|
compose
|
|
|
batch
command
This example demonstrates the BatchNode component for processing multiple inputs through a Graph or Workflow with configurable concurrency and interrupt/resume support.
|
This example demonstrates the BatchNode component for processing multiple inputs through a Graph or Workflow with configurable concurrency and interrupt/resume support. |
|
batch/batch
Package batch provides a BatchNode implementation for processing multiple inputs through a Graph or Workflow with configurable concurrency and interrupt/resume support.
|
Package batch provides a BatchNode implementation for processing multiple inputs through a Graph or Workflow with configurable concurrency and interrupt/resume support. |
|
chain
command
|
|
|
graph/async_node
command
|
|
|
graph/react_with_interrupt
command
|
|
|
graph/simple
command
|
|
|
graph/state
command
|
|
|
graph/tool_call_agent
command
|
|
|
graph/tool_call_once
command
|
|
|
graph/two_model_chat
command
|
|
|
workflow/1_simple
command
|
|
|
workflow/2_field_mapping
command
|
|
|
workflow/3_data_only
command
|
|
|
workflow/4_control_only_branch
command
|
|
|
workflow/5_static_values
command
|
|
|
workflow/6_stream_field_map
command
|
|
|
devops
|
|
|
debug
command
|
|
|
flow
|
|
|
agent/multiagent/host/journal
command
|
|
|
agent/multiagent/plan_execute
command
|
|
|
agent/react
command
|
|
|
agent/react/memory_example
command
|
|
|
agent/deer-go
module
|
|
|
internal
|
|
|
quickstart
|
|
|
chat
command
|
|
|
todoagent
command
|
|
|
eino_assistant
module
|
Click to show internal directories.
Click to hide internal directories.