AitherOS Developer Docs

from adk import AitherAgent

agent = AitherAgent("atlas")
response = await agent.chat("What's the system status?")
print(response.content)

from adk import AitherAgent

agent = AitherAgent("demiurge")

@agent.tool
def search_files(query: str) -> str:
    """Search project files."""
    import glob
    matches = glob.glob(f"**/*{query}*", recursive=True)
    return "\n".join(matches[:10])

response = await agent.chat("Find all Python test files")

from adk.federation import FederationClient

async with FederationClient("http://your-host") as fed:
    await fed.register("my-agent", api_key="ak_xxx")
    await fed.join_mesh(capabilities=["text_gen"])
    result = await fed.chat("Hello from outside!")

# Serve your agent as an OpenAI-compatible API
# $ aither-serve --identity atlas --port 8080

# Then any OpenAI client can connect:
# curl localhost:8080/v1/chat/completions \
#   -d '{"model":"","messages":[{"role":"user","content":"hi"}]}'

from adk.setup import AgentSetup

setup = AgentSetup()
report = await setup.full_setup()

# Smart detection:
# - vLLM running? Uses it (won't start Ollama)
# - Ollama running? Uses it
# - Nothing? Installs + starts Ollama
print(f"Backend: {report.backend}")
print(f"Models: {report.models_available}")