Quick Start#

System Requirements#

  • Python 3.10+

  • Valid DashScope API key

  • Optional: Data-Juicer source code (for custom operator development)

Installation#

# Install uv (if not already)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Installation using uv
uv pip install -e .

Note for Custom Operator Development:

For a better custom operator development experience, you should also download and install Data-Juicer from source:

  1. Clone the repository:

    git clone https://github.com/datajuicer/data-juicer.git

  2. Install it in editable mode:

    uv pip install -e /path/to/data-juicer

    or

    pip install -e /path/to/data-juicer

Editable mode installation is essential to ensure the agent can access real-time operator updates.

  1. Set API Key

export DASHSCOPE_API_KEY="your-dashscope-key"

  1. Optional: Configure Data-Juicer Path (for custom operator development)

export DATA_JUICER_PATH="your-data-juicer-path"

Tip: You can also set this during runtime through conversation, for example:

  • “Help me set the DataJuicer path: /path/to/data-juicer”

  • “Help me update the DataJuicer path: /path/to/data-juicer”

Usage#

Choose the running mode using the -u or --use-studio parameter:

# Use AgentScope Studio's interactive interface (please install and start AgentScope Studio first)
dj-agents --use-studio

# Or use command line mode directly (default)
dj-agents

Note:

Install AgentScope Studio via npm:

npm install -g @agentscope/studio

Start Studio with the following command:

as_studio