Installation

cargo build --package autoagents-cli --release

The binary will be available at target/release/autoagents. You can also install it using cargo install --path ./crates/autoagents-cli

Usage

Run a Workflow

Execute a workflow from a YAML file:

kind: Direct
name: ResearchAgent
stream: false
description: "A research agent designed to search, retrieve, and summarize information from the web."

workflow:
  agent:
    name: ResearchAgent
    description: "A deep research agent capable of gathering accurate information, summarizing sources, and providing references."
    instructions: |
      You are a research expert. Your task is to find accurate and up-to-date information related to the user's query.
      1. Search for relevant sources on the web.
      2. Extract key insights and summarize them concisely.
      3. Provide references and links to original sources.
      4. Make sure to cross-verify facts and avoid unverified information.
      5. Present the final answer in a structured and clear manner.
    executor: ReAct
    memory:
      kind: sliding_window
      parameters:
        window_size: 100
    model:
      kind: llm
      backend:
        kind: Cloud
      provider: OpenAI
      model_name: gpt-4o-mini
      parameters:
        temperature: 0.2
        max_tokens: 1500
    tools:
      - name: brave_search
    output:
      type: text
  output:
    type: text

autoagents run --workflow workflow.yaml --input "What is Rust?"

Serve Workflows over HTTP

Start an HTTP server to serve workflows via REST API:

autoagents serve --workflow workflow.yaml --port 8080

Optional arguments:

• --name <NAME> - Custom name for the workflow (defaults to filename)
• --host <HOST> - Host to bind to (default: 127.0.0.1)
• --port <PORT> - Port to bind to (default: 8080)

Examples

# Run a direct workflow
autoagents run -w workflow.yaml -i "Tell me about AI"

# Serve a workflow on custom port
autoagents serve -w workflow.yaml -p 9000 --name research

# serve from directory
autoagents serve --directory ./workflows

# Serve with custom name
autoagents serve -w workflow.yaml --name my_agent --host 0.0.0.0 --port 3000

📜 License

AutoAgents is dual-licensed under:

• MIT License (MIT_LICENSE)
• Apache License 2.0 (APACHE_LICENSE)

You may choose either license for your use case.

---

🙏 Acknowledgments

Built with ❤️ by the Liquidos AI team and our amazing community contributors.

Special thanks to:

• The Rust community for the excellent ecosystem
• OpenAI, Anthropic, and other LLM providers for their APIs
• All contributors who help make AutoAgents better

---