> ## Documentation Index
> Fetch the complete documentation index at: https://docs.run-agent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install RunAgent CLI and SDK on your system

RunAgent provides Python, JavaScript, Rust, and Go SDKs along with a powerful CLI for deploying and managing AI agents across multiple frameworks.

## Install RunAgent CLI

<Tabs>
  <Tab title="Python">
    Before installing RunAgent, ensure you have Python 3.8+.

    <Steps>
      <Step title="Install RunAgent CLI & Python SDK">
        <CodeGroup>
          ```pip pip theme={null}
          pip install runagent
          ```

          ```uv uv theme={null}
          uv add runagent
          ```
        </CodeGroup>

        The CLI comes bundled with the Python SDK for seamless local development.
      </Step>

      <Step title="Verify Installation">
        Check that RunAgent is installed correctly:

        ```bash theme={null}
        runagent --version
        ```
      </Step>

      <Step title="Setup Authentication (Optional)">
        For cloud deployment and middleware sync features, configure your authentication:

        ```bash theme={null}
        runagent setup
        ```

        This will prompt you to choose between:

        * **Express Setup (Browser login)**: Opens your browser for secure authentication
        * **Manual Setup**: Enter your API key directly

        <Note>
          **Express Setup** uses device code authentication - you'll get a code to enter in your browser, and the CLI will automatically complete the setup once you authenticate.
        </Note>

        To view your current configuration:

        ```bash theme={null}
        runagent whoami
        ```

        To reconfigure:

        ```bash theme={null}
        runagent setup --again
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Install RunAgent SDK

<Tabs>
  <Tab title="Python">
    When RunAgent CLI is installed, the Python SDK is installed as a dependency. You can install it manually as well.

    <Steps>
      <Step title="Install RunAgent Python SDK">
        <CodeGroup>
          ```pip pip theme={null}
          pip install runagent
          ```

          ```uv uv theme={null}
          uv add runagent
          ```
        </CodeGroup>

        The CLI comes bundled with the Python SDK for seamless local development.
      </Step>
    </Steps>
  </Tab>

  <Tab title="JavaScript">
    Before installing the SDK, ensure you have Node.js 16+.

    <Steps>
      <Step title="Install RunAgent SDK">
        <CodeGroup>
          ```npm npm theme={null}
          npm install runagent
          ```

          ```pnpm pnpm theme={null}
          pnpm add runagent
          ```

          ```bun bun theme={null}
          bun add runagent
          ```

          ```yarn yarn theme={null}
          yarn add runagent
          ```
        </CodeGroup>
      </Step>

      <Step title="TypeScript Support">
        The JavaScript SDK comes with full TypeScript support out of the box:

        * Native async/await and Promise support
        * Streaming response handling
        * Type-safe agent invocation
      </Step>
    </Steps>
  </Tab>

  <Tab title="Rust">
    Before installing the SDK, ensure you have Rust 1.70+.

    <Steps>
      <Step title="Add RunAgent to Cargo.toml">
        <CodeGroup>
          ```toml Cargo.toml theme={null}
          [dependencies]
          runagent = "0.1.0"
          tokio = { version = "1.0", features = ["full"] }
          serde_json = "1.0"
          ```
        </CodeGroup>
      </Step>

      <Step title="Install via Cargo">
        <CodeGroup>
          ```bash cargo theme={null}
          cargo add runagent
          ```
        </CodeGroup>
      </Step>

      <Step title="Features">
        The Rust SDK provides:

        * High-performance async operations
        * Streaming support with futures
        * Memory-safe agent interactions
      </Step>
    </Steps>
  </Tab>

  <Tab title="Go">
    Before installing the SDK, ensure you have Go 1.19+.

    <Steps>
      <Step title="Install RunAgent SDK">
        <CodeGroup>
          ```bash go theme={null}
          go get github.com/runagent-dev/runagent-go
          ```
        </CodeGroup>
      </Step>

      <Step title="Import in your project">
        <CodeGroup>
          ```go main.go theme={null}
          import "github.com/runagent-dev/runagent-go/pkg/client"
          ```
        </CodeGroup>
      </Step>

      <Step title="Features (Coming Soon)">
        The Go SDK will provide:

        * Idiomatic Go interfaces
        * Goroutine-based streaming
        * Context-aware operations
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Framework Templates

RunAgent provides pre-built templates for popular AI frameworks to get you started quickly:

<Tabs>
  <Tab title="LangGraph">
    <Steps>
      <Step title="Initialize LangGraph Project">
        <CodeGroup>
          ```bash CLI theme={null}
          runagent init my_langgraph_agent --langgraph
          ```
        </CodeGroup>
      </Step>

      <Step title="What's Included">
        * Pre-configured LangGraph agent setup
        * Streaming and non-streaming entrypoints
        * Sample state management examples
        * Ready-to-deploy configuration
      </Step>
    </Steps>
  </Tab>

  <Tab title="LangChain">
    <Steps>
      <Step title="Initialize LangChain Project">
        <CodeGroup>
          ```bash CLI theme={null}
          runagent init my_langchain_agent --langchain
          ```
        </CodeGroup>
      </Step>

      <Step title="What's Included">
        * LangChain agent with tool support
        * Memory and conversation handling
        * Streaming response capabilities
        * Production-ready configuration
      </Step>
    </Steps>
  </Tab>

  <Tab title="CrewAI">
    <Steps>
      <Step title="Initialize CrewAI Project">
        <CodeGroup>
          ```bash CLI theme={null}
          runagent init my_crew_agent --crewai
          ```
        </CodeGroup>
      </Step>

      <Step title="What's Included">
        * Multi-agent crew setup
        * Task coordination examples
        * Role-based agent configuration
        * Collaborative workflow templates
      </Step>
    </Steps>
  </Tab>

  <Tab title="Custom">
    <Steps>
      <Step title="Initialize Blank Project">
        <CodeGroup>
          ```bash CLI theme={null}
          runagent init my_custom_agent
          ```
        </CodeGroup>
      </Step>

      <Step title="What's Included">
        * Minimal agent template
        * Basic entrypoint examples
        * Configuration file template
        * Development server setup
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Next Steps

After installation, you can:

1. **Initialize your first agent**: `runagent init my_agent`
2. **Start the development server**: `runagent serve my_agent`
3. **Connect from your application** using any of our SDKs
4. **Deploy to production** (coming soon): `runagent deploy my_agent`

<Card title="Still have a question?" icon="circle-question" href="/components/columns">
  * Join our [Discord Community](https://discord.gg/Q9P9AdHVHz)
  * Email us: [hi@run-agent.ai](mailto:hi@run-agent.ai)
  * Follow us on [X](https://x.com/run_agent)
  * New here? [Sign up](https://run-agent.ai/dashboard)
</Card>