The AI Workflow Cross-Platform Engine

English | 简体中文

Table of Contents

• Why AutoAgents Graph?
• Quick Start
• Architecture
• Contributing
• License

Why AutoAgents Graph?

AutoAgents Graph is a revolutionary AI workflow cross-platform engine that allows you to freely convert workflows between different AI platforms through a unified API. It enables seamless navigation through complex AI ecosystems with intelligent workflow orchestration.

• Zero Learning Curve: Unified API design - learn once, use everywhere
• Type Safety: Complete type validation based on Pydantic, ensuring secure workflow transmission
• Platform Compatibility: Supports mainstream platforms like Dify, Agentify, with continuous expansion
• Intelligent Conversion: Automatic node type recognition and conversion, with precise workflow translation

Quick Start

Prerequisites

• Python 3.11+

Installation

pip install autoagents-graph

Examples

AutoAgents Graph provides three main usage patterns:

Text2Workflow - Cross-Platform Converter

from autoagents_graph import Text2Workflow
from autoagents_graph.dify import DifyStartState, DifyLLMState, DifyEndState, START, END

# Create Dify platform workflow
workflow = Text2Workflow(
    platform="dify",
    app_name="Smart Assistant"
)

# Add nodes
workflow.add_node(id=START, state=DifyStartState(title="Start"))
workflow.add_node(id="ai", state=DifyLLMState(title="AI Response"))
workflow.add_node(id=END, state=DifyEndState(title="End"))

# Compile workflow
workflow.compile()

FlowGraph - Agentify Native Builder

from autoagents_graph.agentify import FlowGraph, START
from autoagents_graph.agentify.types import QuestionInputState, AiChatState

# Create Agentify workflow
flow = FlowGraph(
    personal_auth_key="your_key",
    personal_auth_secret="your_secret"
)

# Build intelligent conversation flow
flow.add_node(START, state=QuestionInputState(inputText=True))
flow.add_node("ai", state=AiChatState(model="doubao-deepseek-v3"))
flow.add_edge(START, "ai")

# Publish to platform
flow.compile(name="Smart Chat Assistant")

Supported Node Types

Agentify Platform Nodes

• QuestionInputState - User input node
• AiChatState - AI conversation node
• ConfirmReplyState - Confirmation reply node
• KnowledgeSearchState - Knowledge base search node
• Pdf2MdState - Document parsing node
• AddMemoryVariableState - Memory variable node
• InfoClassState - Information classification node
• CodeFragmentState - Code execution node
• ForEachState - Loop iteration node

Dify Platform Nodes

• DifyStartState - Start node
• DifyLLMState - LLM node
• DifyKnowledgeRetrievalState - Knowledge retrieval node
• DifyEndState - End node

Contributing

We welcome community contributions! Please check the contribution guidelines for detailed processes.

Development Workflow

1. Fork this project
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Create a Pull Request

Contribution Types

• Bug fixes
• New feature development
• Documentation improvements
• Test cases
• Platform adapters

License

This project is licensed under the MIT License - see the LICENSE file for details.