> For the complete documentation index, see [llms.txt](https://docs.oncompute.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oncompute.ai/ocean-orchestrator/using-ocean-orchestrator-with-ocean-dashboard.md).

# Using Ocean Orchestrator with Ocean Dashboard

This guide explains how to select resources, manage payments, and execute jobs by combining the **Ocean Orchestrator Extension** and the **Nodes Dashboard**.

### 1. Project Setup & Connection

Before running a job, ensure your project is ready and connected.

#### Initialize Project

1. **Open Extension**: Click the Ocean icon in your IDE activity bar.
2. **Create Project**: Click "Create a new project folder".
   * Select Language: Python, JavaScript, or Custom Docker Image.
   * *Note: The extension starts with a default environment and minimum resources.*
3. **Select Project**: If you have an existing project, use the folder selector to load it.

#### Node Connection

* **Check Connection**: Use the **Check** button under the "Setup" section at any time to verify the connection to the remote node.
* **Status**: Ensure the status is green (Connected) before proceeding.
* **Error Handling**: The extension will display error messages if the node is unreachable, if there's an OOM (Out of Memory) error, or a bad request.

### 2. Running Free Compute Jobs

Ideal for testing your code logic before spending tokens.

**Flow:**

1. **Open Extension**: Load your project.
2. **Nodes Dashboard**: Click the link to browse nodes offering "Free Compute".
3. **Select Resources**:
   * **Option A (GPU)**: Select a node with a GPU -> Run your benchmark job -> Verify GPU usage in logs (e.g., total compute hashes).
   * **Option B (CPU)**: Don't select a GPU -> Run job -> Verify no GPU hashes are present in logs.
4. **Execute**: Click **Start FREE Compute Job** in the extension.

### 3. Running Paid Compute Jobs

Scale up your workload using high-performance hardware.

**Flow:**

1. **Open Extension**: Load your project.
2. **Nodes Dashboard**: Browse the catalog for specific hardware (e.g., H100, A100).
3. **Select Resources**: Choose the specific node and environment ID.
4. **Deposit & Authorize**:
   * **Deposit**: If you don't have enough tokens in escrow, the system will prompt you to deposit the missing amount.
   * **Authorize**: If you haven't authorized the orchestrator to spend your tokens, you will be prompted to sign an authorization transaction.
5. **Execute**:
   * **Option A (GPU)**: Select a GPU environment -> Run job -> Check logs for GPU activity.
   * **Option B (CPU)**: Select a CPU-only environment -> Run job -> Confirm CPU execution.

### 4. Monitoring & Results

* **Real-Time Logs**: Always keep the **Output Console** open in your IDE to watch the live logs streaming from the node. This is crucial for debugging.
* **Download Results**:
  * Once the job status changes to **Completed**, the results (outputs and logs) are automatically downloaded.
  * Verify the `results/` folder in your project directory contains the expected output files.


---

# 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:

```
GET https://docs.oncompute.ai/ocean-orchestrator/using-ocean-orchestrator-with-ocean-dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.