Installation & Setup
Get Forge running on your system in under 5 minutes. This guide covers installation, authentication setup, and project initialization.
Install and authenticate
Install Forge
Install Forge using the official installation script:
curl -fsSL https://forgecode.dev/cli | sh
This will install the forge command globally on your system.
Start Forge
Navigate to your project directory:
cd your-project-directory
Start Forge
Run Forge:
forge
Complete authentication
Forge offers multiple authentication options:
-
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.
-
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
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
- curl: For downloading the installation script
- 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.