vela-slides

:warning: This project is 100% vibe coded

No human has reviewed the source code.

Every line of Vela — 14,000+ lines of JSX, Python CLI tools, and build scripts — was generated entirely by AI (Claude). The codebase is validated by extensive AI code reviews, 270+ automated tests, and static analysis, but no human has ever read or audited the code.

You are responsible for your own review before using this in any production or sensitive context.

Found something? We have a security bounty program.

---

Get Started

	Approach	Best for
Try instantly	▶ Browse the gallery	View sample decks in any browser — no account needed
	▶ Open the live demo	Interactive artifact on Claude.ai with Vera AI assistant
Set up for creation	Upload as a Claude.ai skill	Generate decks from conversation on Claude.ai
	Run locally with a coding-agent CLI	Full CLI, live preview, file system access — works with any agent that can run shell commands
	Install the desktop app	Native window on Linux/macOS/Windows; Vera routes to your local coding-agent CLI

The Claude.ai artifact runs entirely in your browser. AI features (Vera chat, batch edit) use your Claude.ai subscription. Vela has no backend and no access to your data. Requires Settings → Feature Preview → AI-powered artifacts enabled.

1. Use as a Claude.ai Skill

Upload the skill so Claude generates Vela decks from your descriptions:

1. Download vela-slides-skill-v*.zip from the latest release (or build a fresh one: python3 skills/vela-slides/scripts/vela.py deck zip)
2. In Claude.ai → Customize → Skills → "+" → Upload a skill → upload the ZIP
3. Start a conversation: "Create a 10-slide deck about the future of AI agents"

Claude will generate structured slide JSON, assemble it into the Vela engine, and output an interactive artifact.

2. Run Locally with a Coding-Agent CLI

Full CLI access, live browser preview, file system integration:

git clone https://github.com/AgentiaPT/vela-slides.git
cd vela-slides
python3 skills/vela-slides/scripts/vela.py server start examples/
# → Opens browser at localhost:3030 with deck browser and live editing

The vela CLI is plain Python with structured JSON I/O — any coding-agent CLI that can run shell commands can drive it (Claude Code, GitHub Copilot CLI, Codex CLI, Aider, Cursor's terminal agent, custom agents, etc.). Agents that load the bundled SKILL.md gain Vela's deck conventions and can generate, edit, translate, and rebrand decks while saving 80-97% of tokens vs manual JSON editing. SKILL.md follows the Claude Skills format but is just markdown — drop it into any agent's prompt or system context.

Channel bridge (experimental): Connect the browser UI to your coding-agent CLI for click-to-edit workflows. See skills/vela-slides/channel/README.md.

3. Run as a Desktop App

Vela also ships as a native desktop window built on Neutralino.js. The shell wraps the same Vela engine and replaces the artifact's hosted LLM with a bridge to your locally-installed coding-agent CLI — so Vera's edits, batch ops, and chat all run on your machine via that agent's print/headless mode.