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 run:

npm install -g forgecode@latest
caution

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

Navigate to your project

cd your-project-directory
3

Start Forge

forge
4

Complete authentication

  1. 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 Tutorial
  • Complete your first task with Forge in under 10 minutes.
Essential Commands
  • Learn the core commands for productive development workflows.
Provider Configuration
  • Configure 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

On this page