Skip to main content

​
Prerequisites

Make sure you have:
  • Node.js (v18 or higher recommended)
  • npm installed
  • A Hugging Face account (for LLM access)

​
Clone the repository

git clone https://github.com/codewolfai/codewolf.git
cd codewolf

​
Configure environment variables

cp .env.example .env
Update the .env file: 
# GitHub App credentials
GITHUB_APP_ID=
GITHUB_PRIVATE_KEY_PATH=

# LLM configuration
HF_TOKEN=
HF_MODEL=

​
Install dependencies

npm install

​
Start the server

npm run dev:app
This starts CodeWolf in development mode on http://localhost:3000.

​
Development Setup

At this point, you have a local development instance running. At this stage:
  • The app is running locally for development and testing
  • GitHub integration is not configured yet
  • No webhook events or PR reviews will be processed yet

​
Next steps

You’re now ready to start developing on CodeWolf locally.