Getting started

From zero to a running VampCode app: install the CLI, create a project, edit .vamp files, run.

1. Install

Windows (PowerShell):

irm https://vampcode.vampelium.workers.dev/install.ps1 | iex

macOS / Linux:

curl -fsSL https://vampcode.vampelium.workers.dev/install.sh | bash

This installs vampcode (and the vamp alias), IDE language support for .vamp, and on Windows the file association.

vampcode --version
vampcode ide status

IDEAfter install, in VS Code or Cursor run Developer: Reload Window, then open any .vamp file.

2. Create a project

vampcode create

Kind — Desktop, Web, Mobile, or Backend
Name — e.g. my-web-app

vampcode create shop --type web
vampcode create api --type backend --yes
vampcode create desk --type desktop

3. Run it

cd my-web-app
vampcode run .

Kind	What you should see
Web	Browser + localhost (often `http://127.0.0.1:5173/`)
Desktop / Mobile	Native window with your UI
Backend	Logs only — no window or browser

4. Edit and grow

Path	Role
`main.vamp`	Backend boot / orchestration
`lib/store.vamp`	Storage helpers
`lib/api.vamp`	Business logic
`app/page.vamp`	Home screen UI
`app/server/*.vamp`	Local API handlers
`vamp.toml`	Name, `kind`, capabilities

5. Call local APIs

vampcode call /api/health -p .
vampcode call /api/items -p .

6. First tiny program

@"
print("hello vampcode")
print(1 + 2 * 3)
"@ | Set-Content hello.vamp -Encoding utf8

vampcode run hello.vamp
vampcode eval "len(range(10))"
vampcode repl