> For the complete documentation index, see [llms.txt](https://cimai.gitbook.io/cimai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cimai.gitbook.io/cimai-docs/dolphin-lang/quick-start.md).

# Quick Start

This guide will help you set up your development environment and create your first Dolphin program.

### Prerequisites

Before you begin, make sure you have the following installed:

```bash
# Install Rust and Cargo
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Install Solana CLI tools
sh -c "$(curl -sSfL https://release.solana.com/v1.17.0/install)"

# Install Anchor Framework
cargo install --git https://github.com/coral-xyz/anchor avm --locked
avm install latest
avm use latest

# Install Python 3.8 or higher
# macOS
brew install python@3.8

# Ubuntu
sudo apt-get install python3.8 python3.8-dev
```

### Installation

Install Dolphin using pip:

```bash
pip install dolphin-framework
```

For game development, also install:

```bash
pip install casino-of-life
```

### Create Your First Program

1. Initialize a new project:

```bash
dolphin init hello_world HeLLo777777777777777777777777777777777777777
```

2. Navigate to your new project and open `program/lib.py`:

```python
from dolphin.prelude import *

@program("HeLLo777777777777777777777777777777777777777")
class HelloWorldProgram:
    @account
    class Counter:
        authority: Pubkey
        count: u64
        
    @instruction
    def initialize(
        self,
        counter: Counter,
        authority: Signer,
        system_program: Program = SYSTEM_PROGRAM_ID
    ):
        counter.authority = authority.key()
        counter.count = 0
        
    @instruction
    def increment(
        self,
        counter: Counter,
        authority: Signer
    ):
        assert counter.authority == authority.key(), "Invalid authority"
        counter.count += 1
```

3. Build your program:

```bash
dolphin build
```

4. Run tests:

```bash
dolphin test
```

5. Deploy to Solana devnet:

```bash
dolphin deploy --network devnet
```

### What's Next

* Read the [Architecture Overview](https://github.com/Cimai-Decentralized-Games/dolphin-project/blob/dev/docs/architecture.md) to understand how Dolphin works
* Explore the [Developer Guides](https://github.com/Cimai-Decentralized-Games/dolphin-project/blob/dev/docs/api_reference.md) for detailed documentation
* Check out [Example Programs](https://github.com/Cimai-Decentralized-Games/dolphin-project/blob/dev/examples/README.md) for inspiration
* Join our [Discord Community](https://discord.gg/dolphin) for support

Ready to dive deeper? Continue to [Creating Your First Program](https://claude.ai/chat/guides/first-program.md) for a more detailed walkthrough.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cimai.gitbook.io/cimai-docs/dolphin-lang/quick-start.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
