# Agenticx Quickstart

AgenticX zero-to-hero quickstart guide.

- Repository: https://github.com/DemonDamon/AgenticX (866 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add DemonDamon/AgenticX --skill agenticx-quickstart -g -a claude-code -y`
Codex: `npx skills add DemonDamon/AgenticX --skill agenticx-quickstart -g -a codex -y`
Cursor: `npx skills add DemonDamon/AgenticX --skill agenticx-quickstart -g -a cursor -y`
Gemini CLI: `npx skills add DemonDamon/AgenticX --skill agenticx-quickstart -g -a gemini-cli -y`

## Description

AgenticX zero-to-hero quickstart guide. Use when the user wants to get started with AgenticX, create their first project, build their first agent, or run their first workflow. Covers installation, project scaffolding, agent creation, task execution, and CLI basics.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AgenticX Quickstart

Guide for getting a user from zero to a running AgenticX agent in under 5 minutes.

## Installation

```bash
# Core install (lightweight, ~27 deps, installs in seconds)
pip install agenticx

# Verify
agx --version
```

Optional extras, install only what you need:

| Extra | What it adds | Command |
|-------|-------------|---------|
| `memory` | Mem0, ChromaDB, Qdrant | `pip install "agenticx[memory]"` |
| `document` | PDF/PPT/Word parsing | `pip install "agenticx[document]"` |
| `server` | API server (`agx serve`) | `pip install "agenticx[server]"` |
| `volcengine` | Volcengine AgentKit | `pip install "agenticx[volcengine]"` |
| `all` | Everything | `pip install "agenticx[all]"` |

## Environment

```bash
export OPENAI_API_KEY="sk-..."
# Optional
export ANTHROPIC_API_KEY="sk-ant-..."
```

## Create a Project

```bash
agx project create my-first-agent --template basic
cd my-first-agent
agx project info
```

## Create Your First Agent (Python)

```python
from agenticx import Agent, Task, AgentExecutor
from agenticx.llms import OpenAIProvider

agent = Agent(
    id="data-analyst",
    name="Data Analyst",
    role="Data Analysis Expert",
    goal="Help users analyze and understand data",
    organization_id="my-org"
)

task = Task(
    id="analysis-task",
    description="Analyze sales data trends",
    expected_output="Detailed analysis report"
)

llm = OpenAIProvider(model="gpt-4")
executor = AgentExecutor(agent=agent, llm=llm)
result = executor.run(task)
print(result)
```

## Create via CLI

```bash
# Scaffold an agent
agx agent create researcher --role "Senior Research Analyst"
agx agent list

# Scaffold a workflow
agx workflow create research-pipeline --agents "researcher"

# Run it
agx run workflows/research-pipeline.py --verbose
```

## Add Tools

```python
from agenticx.tools import tool

@tool
def calculate_sum(x: int, y: int) -> int:
    """Calculate the sum of two numbers."""
    return x + y

The rest: https://github.com/DemonDamon/AgenticX/blob/HEAD/agenticx/skills/agenticx-quickstart/SKILL.md