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/agent_with_summarization	Agent Summarization	Adds conversation summarization to long-running ChatModelAgent sessions
adk/intro/http-sse-service	HTTP SSE Service	Exposing ADK Runner as an HTTP service with Server-Sent Events
adk/agentic	Agentic Examples	AgenticModel examples, including research assistant and max-output-token retry
adk/agent/ralph-loop	Ralph Loop	Autonomous iteration loop with filesystem-backed work state and verification gates
adk/cancel/graceful-exit	Graceful Exit	Cancel and resume nested Agents safely from terminal signals
adk/middlewares	Middlewares	Skill middleware and dynamic tool search middleware examples
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, Project Manager, 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, single tool call, 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
quickstart/chatwitheino	Chat with Eino	11-chapter progressive tutorial from ChatModel to Runner, Session, Tool, Middleware, Callback, Interrupt, GraphTool, Skill, A2UI, and TurnLoop

🛠️ 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.

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.