DevSecOps CLI  โ€ข  MIT  โ€ข  now on PyPI

From commit to live.
Automatically.

DeployForge turns shipping an application to production into one command โ€” analyzing your stack, deploying the frontend to Vercel and the backend to Render, wiring environment variables and CORS, then verifying everything is live.

Read the docs
~/projects/my-app โ€” deployforge
$ deployforge
  โœ“ GitHub repository detected              aasz253/my-app
  โœ“ Project detected                        Next.js + FastAPI
  โœ“ Security scan completed                 0 secrets
  โœ“ Backend deployed โ†’ Render               https://api.my-app.onrender.com
  โœ“ Frontend env wired                      NEXT_PUBLIC_API_URL
  โœ“ Frontend deployed โ†’ Vercel              https://my-app.vercel.app
  โœ“ Backend CORS configured                 https://my-app.vercel.app
  โœ“ Deployments verified                    HTTP 200

๐Ÿš€ Application is LIVE
https://my-app.vercel.app
The pipeline

One command. Six stages.

Everything between "it's on GitHub" and "it's live on the internet" โ€” automated and safe.

01

Analyze

DeployForge reads your project and recognizes the topology โ€” Next.js, Vite, FastAPI, Express and more, even inside monorepos.

02

Plan

A deployment plan routes the frontend to Vercel and the backend to Render, choosing the plan you asked for.

03

Secure

A preflight secret scan sweeps your files and blocks the deployment before a credential could ever ship.

04

Deploy

Backend first, then frontend โ€” deployed straight from your GitHub repository through the official provider APIs.

05

Wire

NEXT_PUBLIC_API_URL points at the live backend and FRONTEND_URL opens CORS on it โ€” no copy-paste.

06

Verify

Deployments are polled to ready and every URL is health-checked before the live report is printed.

Why DeployForge

Built for the daily deploy

The wiring you'd otherwise do by hand, folded into one habit.

โšก

One command per release

In a GitHub-backed folder, deployforge is the whole pipeline. No dashboards, no click-dancing.

๐Ÿงญ

Reads your topology

Frontend-only, backend-only, full-stack or monorepo โ€” it detects what you have and deploys exactly that.

๐Ÿ›ก๏ธ

Security-first by default

The preflight scanner blocks deployments carrying leaked credentials before they reach production.

๐Ÿ”

Partial-failure safety

If one service fails, the services already deployed stay live โ€” never a half-destroyed rollout.

๐ŸŒ

Cross-platform

Linux, macOS and Windows. Same command, same output, anywhere.

๐Ÿ”’

Credentials protected

Provider tokens live in your OS keyring, never in your project. Logs store fingerprints, not values.

๐Ÿงฉ

PushForge-native

DeployForge is the second stage of the PushForge workflow โ€” pushforge ships code, deployforge ships it to production.

Security model

Credentials never reach production.

Before anything deploys, DeployForge scans for API keys, private keys, database credentials and high-entropy tokens. If something looks live, the deployment is blocked and the value is never displayed โ€” only a fingerprint is recorded.

deployforge
โš  Potential secret detected

  โœ— GitHub token   api/client.py:88
  โœ— AWS key       config.py:12

Deployment blocked to protect your credentials.
Remove the secrets and run 'deployforge' again.
โœ“

Blocked deployments exit with a clear code โ€” safe for CI

โœ“

Tokens live in your OS keyring, never committed

โœ“

Values never shown โ€” at most a SHA-256 fingerprint

โœ“

Official Vercel & Render APIs only โ€” nothing else is contacted

Install

Available on every OS

Python 3.11+, git and a GitHub-backed project are all you need.

Install
# Debian / Ubuntu
sudo apt install pipx
pipx install deployforge

# Fedora / Arch or any distribution
pipx install deployforge

# one-time path setup (adds ~/.local/bin)
pipx ensurepath
Use it anywhere
cd ~/projects/my-app
deployforge --version      # โœ“ works from any folder
deployforge --dry-run      # preview the whole rollout
deployforge status         # what is live right now
Install (Homebrew pipx)
brew install pipx
pipx install deployforge

# or without Homebrew, using pip
pip3 install --user deployforge
Apple Silicon note
# PyPI ships a universal wheel โ€” no compilation.
# Works identically on Intel and Apple Silicon.
pipx install deployforge
deployforge version
Install (PowerShell)
# install with pip (remember to enable "Add python.exe to PATH")
py -m pip install --user deployforge

# or with pipx
pipx install deployforge
Use it anywhere
cd C:\Users\you\my-app
deployforge --help
deployforge --dry-run
Provider tokens
# Store tokens in your OS keyring (never in the project)
deployforge config --set vercel_token
deployforge config --set render_api_key

# or export them and DeployForge picks them up:
export VERCEL_TOKEN=...
export RENDER_API_KEY=...

# Verify readiness any time
deployforge doctor
PushForge โ†’ DeployForge

From local to live in two commands

PushForge ships your code to GitHub. DeployForge ships it to production.

Full release flow
# 1. Push your code to GitHub
pushforge           # detect โ†’ secure โ†’ repo โ†’ commit โ†’ push

# 2. Ship it to production
deployforge         # analyze โ†’ plan โ†’ deploy โ†’ wire โ†’ verify

# 3. Check what's reachable right now
deployforge status
deployforge verify   # health-check every live URL
Reference

The whole surface of DeployForge

Small enough to remember, deep enough to automate production.

CommandWhat it does
deployforgeFull automated deployment โ€” analyze โ†’ deploy โ†’ verify
deployforge analyzeShow detected architecture and the deployment plan
deployforge deploy --dry-runPreview the entire rollout without touching anything
deployforge initCreate .deployforge/config.yml for a project
deployforge statusShow project, repository, and deployment status
deployforge verifyCheck every deployed URL is reachable and healthy
deployforge securityRun the preflight secret scan independently
deployforge doctorDiagnose the environment and provider readiness
deployforge config --set keyStore provider tokens in your OS keyring
deployforge logsShow recent deployment records
Roadmap

From one command to a platform

The MVP ships without AI. These additions slot right onto the same core.

โœ…

Auto env-wiring ยท shipped

NEXT_PUBLIC_API_URL and FRONTEND_URL set for you.

โœ…

CORS auto-setup ยท shipped

Backend origins configured from the live frontend URL.

โœ…

PushForge handoff ยท shipped

The natural second stage of the PushForge workflow.

๐Ÿ“Š

deployforge metrics

Revenue-grade analytics from Vercel & Render in one table.

โ†ฉ๏ธ

deployforge rollback

One-command rollback to a previous healthy deployment.

๐Ÿค–

deployforge ai

LLM-assisted plan explanations and deployment summaries.

Ship in one command.

pipx install deployforge โ€” then watch production light up.