[Usage] How to Run an online/offline Agent

[longtran1904]

Checked other resources

• I added a very descriptive title to this issue.
• I am sure the issue hasn't been already addressed by searching through https://github.com/agiresearch/AIOS/issues.
• The usage issue is not resolved by updating to the latest stable version in the main branch.

Your current environment

MacOS: Sequoia 15.2
GPU: None
Git branch: v0.2.0.beta

How would you like to use aios

I'm pretty new to agentic AI here.
I saw in kernel.py the option --local_agent, which expresses that I can call agent on my local server, or ... online?

For example, the "Quick Start" document instructed to run demo_author/demo_agents:

python cerebrum/example/run_agent.py --llm_name gpt-4o-mini --llm_backend openai --agent demo_author/demo_agent --task "Tell me what is core idea of AIOS" --aios_kernel_url "http://localhost:8000"

I suppose this command runs an online agent? probably from this agent

I also find in example agents in cerebrum:
/Cerebrum/example/agents

I suppose these ones I can call local agent?

My question:

1. How can run local agents - what path should I pass to the command? path to math_agent dir or path to agent.py?
2. How/where do find a list of references for "online" agents that I can call?

Any help or guidance is appreciated.

Many thanks.

[badmachine1902]

I suppose it should work when passing the folder name

[lxjmaster]

I have reviewed their relevant code, and this functionality does not seem to be fully developed yet. Currently, only local agent can be used. Online agent require accessing their link to download the agent, but I have tried and found that the link is currently unavailable