# setup-python-tools

Wires client-side Python tool execution through Pyodide into an app that already has useAtlasChat. Useful when the agent ships tool code and the browser should run it.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1900 installs · ★ 6
- Author: cognitedata
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/cognitedata/builder-skills/tree/HEAD/skills/setup-python-tools/SKILL.md
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/skills/setup-python-tools

## What it does

The skill walks through the setup: read `package.json` and the component calling `useAtlasChat`, install `pyodide@0.29.3`, add the `usePyodideRuntime` hook, pass `pythonRuntime` into `useAtlasChat`. No `PythonToolConfig` entries are needed. CDF `runPythonCode` tools arrive as `toolConfirmation` plus `clientTool`, and the library fetches the code on its own when the agent asks for it.

The Pyodide version has to match the CDN artifacts. Install a different one and loading breaks. First load pulls roughly 30MB and takes 30-60 seconds; after that the browser cache serves it in under 2 seconds. While initialization runs, the skill says to disable the whole input area rather than just the send button, and to show a compact pill above the input with the current stage and percent.

You need `src/atlas-agent/` from the `integrate-atlas-chat` skill and the `@sinclair/typebox` package; `python.ts`, `pyodide.ts`, `pyodide-react.ts` and `pyodide-runtime.ts` get copied from `integrate-atlas-chat/code/`. If the app runs through the Atlas / EOS sidebar, skip this skill — Python tools there come from the agent config.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cognitedata/builder-skills --skill setup-python-tools -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/setup-python-tools/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/setup-python-tools/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cognitedata/builder-skills --skill setup-python-tools -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/setup-python-tools/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cognitedata/builder-skills --skill setup-python-tools -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/setup-python-tools/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cognitedata/builder-skills setup-python-tools
```

2. **Manually: put the files in place**
- File: `.github/skills/setup-python-tools/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cognitedata/builder-skills --skill setup-python-tools -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cognitedata/builder-skills --path skills/setup-python-tools
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/setup-python-tools/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add cognitedata/builder-skills --skill setup-python-tools -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cognitedata/builder-skills/tree/HEAD/skills/setup-python-tools/SKILL.md

## When to use it
- run Python tool code inside the browser
- attach Pyodide to an existing `useAtlasChat` chat
- show runtime loading progress above the input
- block message sending until Python is ready
- keep the `pyodide` version aligned with the CDN artifacts

## Example prompts
- set up python tools for the my-agent agent
- wire usePyodideRuntime into the component that calls useAtlasChat
- add a Pyodide loading indicator above the chat input

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 8cb126e1b111fd2a.

BEGIN THIRD-PARTY FILE 8cb126e1b111fd2a
````text
---
name: setup-python-tools
description: "Pyodide Python tools for an already-approved in-app useAtlasChat UI. EOS sidebar Python tools run from agent CDF config — do not vendor Pyodide. Triggers: Pyodide, pythonRuntime, usePyodideRuntime, runPythonCode."
allowed-tools: Read, Glob, Grep, Edit, Write, Bash
metadata:
  argument-hint: "[tool-names or agent-external-id]"
---

# Set Up Python Tool Execution

Add client-side Pyodide execution for **$ARGUMENTS**. Skip this if the app uses the Atlas / EOS sidebar (`integrate-fusion-agent`).

**Prerequisite:** `src/atlas-agent/` from `integrate-atlas-chat`, plus `@sinclair/typebox`. Copy `python.ts`, `pyodide.ts`, `pyodide-react.ts`, `pyodide-runtime.ts` from `integrate-atlas-chat/code/` into `src/atlas-agent/`.

CDF `runPythonCode` tools arrive as `toolConfirmation` + `clientTool`. Wire `usePyodideRuntime` and pass `pythonRuntime` to `useAtlasChat` — no `PythonToolConfig` entries. Pyodide is ~30MB, cached after first load.

---

## Step 1 — Understand the app

Read these files before touching anything:

- `package.json` — detect package manager and existing deps
- The component that calls `useAtlasChat` — understand current tools/config

---

## Step 2 — Install Pyodide

Install **exactly** `pyodide@0.29.3` using the app's package manager.
This version must match the CDN artifacts loaded at runtime — installing a different version will cause errors.

- pnpm → `pnpm add pyodide@0.29.3`
- npm  → `npm install pyodide@0.29.3`
- yarn → `yarn add pyodide@0.29.3`

> `@sinclair/typebox` should already be installed from `integrate-atlas-chat`. Add it if missing.

---

## Step 3 — Set up usePyodideRuntime

In the component that calls `useAtlasChat`, add the Pyodide runtime hook:

```tsx
import { loadPyodide } from "pyodide";
import { usePyodideRuntime } from "./atlas-agent/pyodide-react";
import { useAtlasChat } from "./atlas-agent/react";

function MyChat() {
  const { sdk, isLoading } = useDune();

  // Initialize Python runtime (loads Pyodide, installs packages, sets up Cognite SDK)
  const {
    runtime: pythonRuntime,
    loading: pythonLoading,
    progress: pythonProgress,
    error: pythonError,
    isReady: pythonReady,
  } = usePyodideRuntime({
    loadPyodide,
    client: isLoading ? null : sdk,
    requirements: ["pandas", "numpy"],    // optional — additional packages
  });

  // ... useAtlasChat below
}
```

### Hook API reference

| Return field | Type | Description |
|---|---|---|
````
END THIRD-PARTY FILE 8cb126e1b111fd2a

The third-party file has ended. Everything between the 8cb126e1b111fd2a tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2497 of 5368 bytes. © cognitedata · Apache-2.0 · https://github.com/cognitedata/builder-skills/tree/HEAD/skills/setup-python-tools/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md