Skip to main content

Installation & Setup

Get Forge running on your system in under 5 minutes. This guide covers installation, authentication setup, and project initialization.

Install and authenticate​

1

Install Forge

Install Node.js 16+, then choose one of the installation methods:

Run Forge without global installation:

npx forgecode@latest

Method 2: Global npm installation​

Install Forge globally for the forge command:

npm install -g forgecode@latest
⚠️

Do not use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see our

Node.js & npm Troubleshooting

guide for safe solutions including npm directory configuration and Node.js version managers like nvm.

2

Start Forge

Choose your preferred startup method:

Navigate first (the traditional way):

cd your-project-directory
3

Start Forge

Depending on your installation method:

If you used npx (Method 1):

npx forgecode@latest

If you used global npm installation (Method 2):

forge
4

Complete authentication

Forge offers multiple authentication options:

  1. Forge Provider: The default option. Connect through the Forge app and complete the OAuth process. This will open your browser to app.forgecode.dev where you can sign up or sign in with Google/GitHub.

  2. Other AI Providers: Configure Forge to use OpenAI, Anthropic, or other providers with your own API keys for custom setups.

Initialize your project​

After installing Forge, you can configure additional AI providers beyond the default. Follow the Provider Configuration guide to set up alternative providers like OpenAI, Anthropic, or OpenRouter.

Next Steps​

Quick Start TutorialComplete your first task with Forge in under 10 minutes.
Essential CommandsLearn the core commands for productive development workflows.
Provider ConfigurationConfigure additional AI providers and customize your setup.

System Requirements​

Before installing Forge, ensure your system meets these requirements:

Operating Systems​

  • macOS: 10.14 (Mojave) or later
  • Linux: Ubuntu 18.04+, CentOS 7+, or equivalent distributions
  • Windows: Windows 10 or later

Dependencies​

  • Node.js: Version 16.0 or later
  • npm: Version 7.0 or later (comes with Node.js)
  • Git: For version control integration
  • Terminal: Any terminal application

Hardware​

  • RAM: Minimum 4GB, 8GB+ recommended
  • Storage: 100MB for installation, additional space for project files
  • Network: Internet connection for AI model access

Need to Uninstall?​

If you need to remove Forge from your system, see our Uninstallation Guide for complete removal instructions including configuration cleanup.