Security advisory — Malicious litellm versions 1.82.7 and 1.82.8 were removed from PyPI (potential API key exfiltration). Uninstall them, rotate exposed credentials, and upgrade to a safe release (e.g. 1.82.9+ per upstream). Run pip show litellm to verify. PyPI · README

Quick Start

Get up and running in 5 minutes.

Quick Start

Get up and running in 5 minutes.

1. Install

bash
1pip install agenticx

2. Create Your First Agent

python
1from agenticx import Agent, Task, AgentExecutor
2from agenticx.llms import OpenAIProvider
3
4# Define the agent
5agent = Agent(
6 id="data-analyst",
7 name="Data Analyst",
8 role="Data Analysis Expert",
9 goal="Help users analyze and understand data",
10 organization_id="my-org"
11)
12
13# Define a task
14task = Task(
15 id="analysis-task",
16 description="Analyze sales data trends for Q4 2025",
17 expected_output="A detailed analysis report with key insights"
18)
19
20# Run
21llm = OpenAIProvider(model="gpt-4o")
22executor = AgentExecutor(agent=agent, llm=llm)
23result = executor.run(task)
24print(result)

3. Add Tools

Give your agent the ability to call custom functions:

python
1from agenticx.tools import tool
2from agenticx import Agent, Task, AgentExecutor
3from agenticx.llms import OpenAIProvider
4
5@tool
6def calculate_sum(x: int, y: int) -> int:
7 """Calculate the sum of two numbers."""
8 return x + y
9
10@tool
11def search_web(query: str) -> str:
12 """Search the web for information."""
13 # integrate with your search provider
14 return f"Results for: {query}"
15
16agent = Agent(
17 id="assistant",
18 name="Assistant",
19 role="General Assistant",
20 goal="Help with any task",
21 organization_id="my-org"
22)
23
24task = Task(
25 description="What is 42 + 58?",
26 expected_output="The numerical answer"
27)
28
29executor = AgentExecutor(agent=agent, llm=OpenAIProvider(), tools=[calculate_sum, search_web])
30result = executor.run(task)

4. CLI Quick Start

After installation, the agx CLI is available:

bash
1# Create a new project
2agx project create my-agent --template basic
3cd my-agent
4
5# Start the Studio API server
6agx serve --port 8000
7
8# Run a workflow file
9agx run workflows/my_pipeline.py --verbose

5. Use the Studio UI

AgenticX ships with a web-based Studio for managing agents, sessions, and group chats:

bash
1agx serve --port 8000
2# Open http://localhost:8000 in your browser

Next Steps