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

# Installation

> How to install 2501 CLI on your machine

The 2501 CLI is a Node.js-based command-line tool that brings autonomous AI agents directly to your terminal. Installation takes just a few minutes.

## System Requirements

* **Node.js**: Version 16.x or higher
* **npm**: Included with Node.js
* **Operating System**: macOS, Linux, or Windows

Verify your Node.js installation:

```bash theme={null}
node --version
```

If Node.js isn't installed, download it from [nodejs.org](https://nodejs.org/).

## Installation

Install the 2501 CLI globally to access it from anywhere:

```bash theme={null}
npm install -g @2501-ai/cli
```

This makes the `@2501` command available system-wide.

### Verify Installation

Confirm the CLI is installed:

```bash theme={null}
@2501 --version
```

You should see the installed version number.

## Next Steps

After installation, authenticate the CLI with your 2501 account:

1. Get your API key from [accounts.2501.ai](https://accounts.2501.ai)
2. Follow the [Authentication](/0.4/cli/authentication) guide
3. Start using the CLI with the [Commands](/0.4/cli/commands) reference

## Updating

Update to the latest version:

```bash theme={null}
npm update -g @2501-ai/cli
```

Check for available updates:

```bash theme={null}
npm outdated -g @2501-ai/cli
```

## Troubleshooting

**Permission Errors on macOS/Linux**

If you encounter permission errors, you may need `sudo`:

```bash theme={null}
sudo npm install -g @2501-ai/cli
```

Alternatively, configure npm to install global packages without `sudo` by following [npm's documentation](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally).

**Command Not Found**

If the `@2501` command isn't recognized after installation, verify the installation completed successfully. Check that npm's global bin directory is in your PATH, restart your terminal, and try reinstalling if needed.

**Windows Installation Issues**

On Windows, you may need to run your terminal as Administrator, use PowerShell or Command Prompt instead of Git Bash, or ensure npm is properly configured for global installations.

For additional support, visit our [Discord community](https://discord.gg/DYC8ryeC7e) or contact [hello@2501.ai](mailto:hello@2501.ai).