cardano-devnet-in-a-box

Set up a local Cardano devnet with node, Hydra, Ogmios, and Kupo.

8|2|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/Flux-Point-Studios/cardano-agent-skills --skill cardano-devnet-in-a-box
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cardano-devnet-in-a-box
Source: https://github.com/Flux-Point-Studios/cardano-agent-skills/tree/main/skills/cardano-devnet-in-a-box
Command: npx skills add https://github.com/Flux-Point-Studios/cardano-agent-skills --skill cardano-devnet-in-a-box

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a one-command solution to set up a complete local Cardano development and rehearsal environment, enabling rapid iteration and testing of dApps and smart contracts before deploying to testnets or mainnet.

Core Features & Use Cases

  • Local Devnet: Spins up a fully functional Cardano node, Hydra nodes, Ogmios, and Kupo.
  • End-to-End Testing: Facilitates building, signing, and submitting transactions in a realistic local setting.
  • DApp Infrastructure: Integrates essential services like Ogmios for chain indexing and Kupo for UTxO lookups.
  • Deterministic Rehearsal: Includes a built-in rehearsal script for green/red testing of core workflows, including Plutus script spends within Hydra.

Quick Start

Run the command to bring up the local Cardano rehearsal stack.

Frequently Asked Questions about cardano-devnet-in-a-box

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a local Cardano devnet for smart contract testing?

You can set up a local Cardano devnet by running a single command to deploy a full stack via Docker, including cardano-node, Ogmios, and Kupo for realistic local testing.

Do I need Docker to run a local Cardano rehearsal environment?

Yes, Docker and docker-compose are required to run the local Cardano rehearsal environment, along with git and specific available ports to support the Hydra and node infrastructure.

Can I test Plutus smart contract transactions inside Hydra heads locally?

Yes, you can perform deterministic green and red testing of Plutus script spends directly within Hydra heads using the built-in rehearsal script for end-to-end transaction validation.

What is the best way to run Ogmios and Kupo for Cardano dApp infrastructure locally?

The best way is deploying a local rehearsal stack that automatically integrates Ogmios for chain indexing and Kupo for UTxO lookups alongside cardano-node and Hydra.

How does a deterministic rehearsal environment improve Cardano dApp testing?

A deterministic rehearsal environment provides a stable local setting to build, sign, and submit transactions, ensuring reliable green and red testing of smart contract interactions before testnet deployment.

Why spin up a local Cardano stack instead of deploying directly to a testnet?

Spinning up a local Cardano stack enables rapid iteration and end-to-end testing of dApps and smart contracts without the latency or resource constraints of using a public testnet.