AgentOS Research App - Deploy Your Parallel Agent
Serve a Parallel-powered research agent through the AgentOS REST API.
Serve a Parallel-powered research agent through AgentOS. Open http://localhost:7777/docs for the API explorer, or connect the running instance to the AgentOS control plane. The local API server does not serve the control-plane chat application.
"""
AgentOS Research App - Deploy Your Parallel Agent
=================================================
Wrap a Parallel-powered research agent in AgentOS to get a production API
and the AgentOS control plane in a few lines. Run this file and open
http://localhost:7777 to chat with the agent or call its REST API.
Because this filename starts with a number, we pass the FastAPI app object to
serve() directly (live reload would need an importable "module:app" string).
Prerequisites:
- pip install parallel-web
- export PARALLEL_API_KEY=<your-api-key>
"""
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.openai import OpenAIResponses
from agno.os import AgentOS
from agno.tools.parallel import ParallelTools
# ---------------------------------------------------------------------------
# Create the Agent and AgentOS app
# ---------------------------------------------------------------------------
db = SqliteDb(db_file="tmp/parallel_os.db")
research_agent = Agent(
name="Parallel Research Agent",
model=OpenAIResponses(id="gpt-5.4"),
tools=[ParallelTools(enable_search=True, enable_extract=True, enable_task=True)],
db=db,
add_history_to_context=True,
markdown=True,
instructions=[
"You are a web research agent powered by Parallel.",
"Use Search and Extract for fast lookups and the Task API for deep, "
"cited research.",
],
)
agent_os = AgentOS(
description="Parallel-powered research app",
agents=[research_agent],
)
app = agent_os.get_app()
# ---------------------------------------------------------------------------
# Run the App
# ---------------------------------------------------------------------------
if __name__ == "__main__":
# Open http://localhost:7777 (API docs at /docs, config at /config).
agent_os.serve(app=app)Local development
This file starts a local API backed by SQLite. It does not configure authentication or deploy the service. Before exposing it to users, configure AgentOS security and your deployment environment.
Run the Example
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activateInstall dependencies
uv pip install -U "agno[os]" openai parallel-webExport your API keys
export OPENAI_API_KEY="your_openai_api_key_here"
export PARALLEL_API_KEY="your_parallel_api_key_here"Run the example
Save the code above as agent_os_app.py, then run:
python agent_os_app.pyFull source: cookbook/integrations/parallel/09_agent_os_app.py