Automated Local Setup (Claude Code Skill)
Instead of manually configuring your entire development environment, you can use our official Claude Code skill: otoshek-local-setup. This skill completely automates downloading, configuring, and running your newly deployed project locally.
What it Automates
After Otoshek deploys your app, you'll receive a GitHub repository. Running the skill automates:
- Prerequisite Validation: Verifies core system requirements are installed and stops with exact install commands if any are missing.
- Software Setup: Installs and configures PostgreSQL and VS Code.
- SSL Configuration: Configures HTTPS SSL certificates for local development.
- Database Setup: Creates and configures your local PostgreSQL database.
- Backend Environment: Sets up your Python virtual environment and installs dependencies.
- Database Migrations: Applies Django migrations and creates a superuser.
- Environment Files: Automatically fills in your
.envfile (Google OAuth, Mailjet, Stripe). - Stripe Sync: Connects and syncs Stripe products and pricing from test mode.
- Editor Configuration: Sets up VS Code with F5 launch configurations to run both Django and React simultaneously.
The skill supports macOS, Linux, and Windows, automatically detecting what's already installed and gracefully skipping steps that are already completed.
Prerequisites
You must have the following system dependencies installed before running the skill. The skill will check for these on startup.
macOS
# 1. Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. Required tools
brew install git node python@3.13 mkcert
mkcert -install
Linux
# 1. Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. Required tools
sudo apt update && sudo apt install -y git nodejs npm
brew install python@3.13 mkcert
mkcert -install
Windows
Install the following tools manually (no Homebrew on Windows):
- Git — accept default settings
- Node.js — LTS version
- Python 3.13 — enable "Add Python to PATH"
- mkcert — download
mkcert-*.exe, rename tomkcert.exe, add to PATH, then run:mkcert -install
Or install via Chocolatey: choco install git nodejs python mkcert then mkcert -install
You'll also need:
- A GitHub account with access to your newly deployed Otoshek repository.
- Your API credentials (Google OAuth, Mailjet, Stripe) prepared from the Otoshek setup wizard.
Installation
Follow these quick steps to install the required tools and the setup skill.
01Install Claude Code (skip if installed)
Download and install the Claude Code CLI tool via curl.
curl -fsSL https://claude.ai/install.sh | bash02Add the Otoshek Plugin Marketplace
Open your terminal and run Claude Code in any directory, then add the marketplace.
/plugin marketplace add otoshek/otoshek-local-setup03Install the Skill
Install the official otoshek-local-setup skill to make it available in all future Claude sessions. (Requires Claude Code v1.0.33+)
/plugin install otoshek-local-setup@otoshek-otoshek-local-setupTriggering the Setup
Open a terminal in the directory where you want your project to be cloned and initialized. Start Claude Code, and paste in the setup command alongside the repository link provided after your deployment.
/otoshek-local-setup git@github.com:YOUR_USERNAME/YOUR_REPO.git
When it will pause
While the skill is highly automated, it will pause and wait for your input in a few specific scenarios:
- SSH Key Generation: If Claude doesn't detect working GitHub SSH keys, it will generate one, copy it to your clipboard, and pause. It will ask you to paste that key into your GitHub account settings and confirm before continuing.
- Environment Variables: The skill will pause and ask you to paste your specific credentials into the chat so it can populate your local environment files. It will ask for your Google OAuth Client ID & Secret, Mailjet API Keys & Sender Email, Stripe Test Secret Key, and your Stripe Price IDs (6 values).
Running the App
The skill configures VS Code perfectly, but you still need to know how to actually launch the app once the skill finishes running.
- The skill should have already opened the project in VS Code automatically. If not, open the project folder in VS Code.
- Go to the Run and Debug sidebar (Ctrl+Shift+D or Cmd+Shift+D).
- Crucial Step: Select "Django + Frontend" from the debug dropdown menu at the top. (VS Code defaults to just the "Django_server" configuration).
- Press F5 to launch both servers simultaneously in integrated terminals.
- Open https://localhost:5173 in your browser (emphasize the
https://).
