# V-Run Docs

> Official documentation for V-Run — the AI-powered platform that generates, tests, and runs Python workflows in the cloud. Guides, concepts, features, and the API reference.

## Docs

- [V-Run documentation](https://docs.virtualityhub.com/index.md): V-Run is an AI-powered platform that generates, tests, and runs production-ready Python workflows in the cloud. Commit to publish — no environment pipelines.
- [Quickstart](https://docs.virtualityhub.com/quickstart.md): Sign up, describe what you need, and ship your first V-Run Python workflow in minutes — with AI code generation, built-in tests, and a single-commit publish.
- [Workflows](https://docs.virtualityhub.com/concepts/workflows.md): Anatomy of a V-Run workflow: main code, tests, requirements, and config.yaml — the building blocks for AI-generated Python workflows running in the cloud.
- [Triggers](https://docs.virtualityhub.com/concepts/triggers.md): Trigger V-Run Python workflows manually, via HTTP API with an x-api-key, or on a cron schedule — with a copy-to-n8n HTTP node for one-click integration.
- [AI code generation](https://docs.virtualityhub.com/features/ai-code-generation.md): Describe what you need and V-Run's Claude-powered AI assistant generates, edits, and explains production-ready Python workflow code inside your browser.
- [Code editor](https://docs.virtualityhub.com/features/code-editor.md): V-Run's browser-based Python IDE uses Monaco — the engine behind VS Code — with syntax highlighting, autocomplete, diagnostics, and multi-file tabs.
- [Testing](https://docs.virtualityhub.com/features/testing.md): Write and run pytest tests against your V-Run Python workflows in the same cloud sandbox as production — so every commit ships verified code.
- [Version control](https://docs.virtualityhub.com/features/version-control.md): Commit, browse history, diff, and restore versions of your V-Run workflow. Committing publishes — no separate deploy step, no environment pipeline.
- [Secrets and environment variables](https://docs.virtualityhub.com/features/secrets-and-variables.md): Inject encrypted secrets and environment variables into V-Run Python workflows at runtime — declared in config.yaml and scoped per workflow.
- [Scheduling](https://docs.virtualityhub.com/features/scheduling.md): Schedule V-Run Python workflows with standard cron expressions and IANA timezones — perfect for ETL pipelines, daily reports, and recurring automation.
- [Cost and credits](https://docs.virtualityhub.com/features/cost-and-credits.md): V-Run uses pay-as-you-go credits starting at $5 with real-time per-run cost tracking across compute, storage, and AI inference — no subscriptions.
- [API overview](https://docs.virtualityhub.com/api-reference/introduction.md): Trigger V-Run Python workflows programmatically via HTTPS from your backend, CI/CD, webhooks, or n8n — with per-workflow API keys and JSON input payloads.
- [Authentication](https://docs.virtualityhub.com/api-reference/authentication.md): Authenticate V-Run API requests with a per-workflow API key passed in the x-api-key header. Includes code samples in Python, JavaScript, and cURL.
- [Execute workflow](https://docs.virtualityhub.com/api-reference/trigger-workflow.md): POST /api/workflows/{workflowId}/execute to run a published V-Run workflow. Pass JSON inputs or multipart files and receive outputs, cost, and duration.
- [AGENTS](https://docs.virtualityhub.com/AGENTS.md)

## Optional

- [Website](https://apps.virtualityhub.com)
- [Blog](https://blog.virtualityhub.com)