Start with CLI Mode

[🚨 News: ] We have updated a more easy-to-use command to start the CLI mode and fix the bug of different LLM providers from issues. You can follow the following steps to start the CLI mode with different LLM providers with much less configuration.

Command Options:

You can run auto main to start full part of AutoAgent, including user mode, agent editor and workflow editor. Btw, you can also run auto deep-research to start more lightweight user mode, just like the Auto-Deep-Research project. Some configuration of this command is shown below.

• --container_name: Name of the Docker container (default: ‘deepresearch’)
• --port: Port for the container (default: 12346)
• COMPLETION_MODEL: Specify the LLM model to use, you should follow the name of Litellm to set the model name. (Default: claude-3-5-sonnet-20241022)
• DEBUG: Enable debug mode for detailed logs (default: False)
• API_BASE_URL: The base URL for the LLM provider (default: None)
• FN_CALL: Enable function calling (default: None). Most of time, you could ignore this option because we have already set the default value based on the model name.
• git_clone: Clone the AutoAgent repository to the local environment (only support with the auto main command, default: True)
• test_pull_name: The name of the test pull. (only support with the auto main command, default: ‘autoagent_mirror’)

More details about git_clone and test_pull_name]

In the agent editor and workflow editor mode, we should clone a mirror of the AutoAgent repository to the local agent-interactive environment and let our AutoAgent automatically update the AutoAgent itself, such as creating new tools, agents and workflows. So if you want to use the agent editor and workflow editor mode, you should set the git_clone to True and set the test_pull_name to ‘autoagent_mirror’ or other branches.

auto main with different LLM Providers

Then I will show you how to use the full part of AutoAgent with the auto main command and different LLM providers. If you want to use the auto deep-research command, you can refer to the Auto-Deep-Research project for more details.

Anthropic

• set the ANTHROPIC_API_KEY in the .env file.

ANTHROPIC_API_KEY=your_anthropic_api_key

• run the following command to start Auto-Deep-Research.

auto main # default model is claude-3-5-sonnet-20241022

OpenAI

• set the OPENAI_API_KEY in the .env file.

OPENAI_API_KEY=your_openai_api_key

• run the following command to start Auto-Deep-Research.

COMPLETION_MODEL=gpt-4o auto main

Mistral

• set the MISTRAL_API_KEY in the .env file.

MISTRAL_API_KEY=your_mistral_api_key

• run the following command to start Auto-Deep-Research.

COMPLETION_MODEL=mistral/mistral-large-2407 auto main

Gemini - Google AI Studio

• set the GEMINI_API_KEY in the .env file.

GEMINI_API_KEY=your_gemini_api_key

• run the following command to start Auto-Deep-Research.

COMPLETION_MODEL=gemini/gemini-2.0-flash auto main

Huggingface

• set the HUGGINGFACE_API_KEY in the .env file.

HUGGINGFACE_API_KEY=your_huggingface_api_key

• run the following command to start Auto-Deep-Research.

COMPLETION_MODEL=huggingface/meta-llama/Llama-3.3-70B-Instruct auto main

Groq

• set the GROQ_API_KEY in the .env file.

GROQ_API_KEY=your_groq_api_key

• run the following command to start Auto-Deep-Research.

COMPLETION_MODEL=groq/deepseek-r1-distill-llama-70b auto main

OpenAI-Compatible Endpoints (e.g., Grok)

• set the OPENAI_API_KEY in the .env file.

OPENAI_API_KEY=your_api_key_for_openai_compatible_endpoints

• run the following command to start Auto-Deep-Research.

COMPLETION_MODEL=openai/grok-2-latest API_BASE_URL=https://api.x.ai/v1 auto main

OpenRouter (e.g., DeepSeek-R1)

We recommend using OpenRouter as LLM provider of DeepSeek-R1 temporarily. Because official API of DeepSeek-R1 can not be used efficiently.

• set the OPENROUTER_API_KEY in the .env file.

OPENROUTER_API_KEY=your_openrouter_api_key

• run the following command to start Auto-Deep-Research.

COMPLETION_MODEL=openrouter/deepseek/deepseek-r1 auto main

DeepSeek

• set the DEEPSEEK_API_KEY in the .env file.

DEEPSEEK_API_KEY=your_deepseek_api_key

• run the following command to start Auto-Deep-Research.

COMPLETION_MODEL=deepseek/deepseek-chat auto main

After the CLI mode is started, you can see the start page of AutoAgent:

Tips

Import browser cookies to browser environment

You can import the browser cookies to the browser environment to let the agent better access some specific websites. For more details, please refer to the cookies folder.

Add your own API keys for third-party Tool Platforms

If you want to create tools from the third-party tool platforms, such as RapidAPI, you should subscribe tools from the platform and add your own API keys by running process_tool_docs.py.

python process_tool_docs.py

More features coming soon! 🚀 Web GUI interface under development.

cd path/to/AutoAgent && sh evaluation/gaia/scripts/run_infer.sh

cd path/to/AutoAgent && python evaluation/gaia/get_score.py

cd path/to/AutoAgent && sh evaluation/multihoprag/scripts/run_rag.sh

@misc{AutoAgent,
      title={{AutoAgent: A Fully-Automated and Zero-Code Framework for LLM Agents}},
      author={Jiabin Tang, Tianyu Fan, Chao Huang},
      year={2025},
      eprint={202502.05957},
      archivePrefix={arXiv},
      primaryClass={cs.AI},
      url={https://arxiv.org/abs/2502.05957},
}