algorand-python

name

algorand-python

description

Comprehensive guide for Algorand Python (PuyaPy) smart contract development — contract building with decorators, storage, transactions, types, AlgoKit Utils, ARC standards, and troubleshooting. This is the parent skill for all Python-specific Algorand content. Use when writing Python contract code, working with algopy decorators, understanding Algorand Python storage patterns, using AlgoKit Utils in Python, or troubleshooting Python-specific errors. Strong triggers include "Algorand Python", "PuyaPy", "algopy", "ARC4Contract", "@arc4.abimethod", "GlobalState Python", "BoxMap Python", "algokit_utils Python", "pip install algokit-utils", "Python contract", "Python smart contract".

Algorand Python

This is the aggregated parent skill for all Python-specific Algorand development. Use the reference files below to find detailed guidance for each topic.

Quick Start

# Create Python project
algokit init -n my-project -t python --answer preset_name production --defaults

# Install AlgoKit Utils
pip install algokit-utils

# Development cycle
algokit project run build    # Compile Python contracts
algokit project run test     # Run tests

Key Python Pattern

from algopy import ARC4Contract, arc4

class MyContract(ARC4Contract):
    @arc4.abimethod
    def hello(self, name: arc4.String) -> arc4.String:
        return arc4.String("Hello, " + name.native)

Reference Guide

Navigate to the appropriate reference based on your task. Each topic has one or more files.

Creating Python Projects

Initialize Python AlgoKit projects with proper templates and presets.

• create-project.md — Python project creation
• create-project-reference.md — Python presets and templates

Building Smart Contracts (Python)

Python-specific contract building with PuyaPy, including deep-dive references for decorators, storage, transactions, and types.

• build-smart-contracts.md — Python contract building guide
• build-smart-contracts-reference.md — Python repos and patterns
• build-smart-contracts-decorators.md — @arc4.abimethod, @arc4.baremethod, @subroutine
• build-smart-contracts-storage.md — GlobalState, LocalState, Box, BoxMap, BoxRef
• build-smart-contracts-transactions.md — Inner transactions, group transactions, fee pooling
• build-smart-contracts-types.md — AVM types, ARC-4 types, reference types

AlgoKit Utils (Python)

Interact with Algorand from Python applications.

• use-algokit-utils.md — Python AlgoKit Utils overview
• use-algokit-utils-reference.md — AlgorandClient Python API reference

Implementing ARC Standards (Python)

Python implementations of ARC-4, ARC-32, and ARC-56.

• implement-arc-standards.md — Python ARC overview
• implement-arc-standards-arc4.md — Python ARC-4 implementations
• implement-arc-standards-arc32-arc56.md — Python typed client usage

Troubleshooting Errors (Python)

Python-specific error diagnosis and fixes.

• troubleshoot-errors.md — Python error overview
• troubleshoot-errors-contract.md — Contract errors with Python fixes
• troubleshoot-errors-transaction.md — Transaction errors with Python fixes

Topic Quick Reference

Topic	Files	Description
Create Project	2	Python template initialization
Build Contracts	6	PuyaPy contracts, decorators, storage, transactions, types
AlgoKit Utils	2	AlgorandClient Python API
ARC Standards	3	Python ARC implementations
Troubleshoot	3	Python error fixes

How to Use This Skill

1. Start here to understand which reference you need
2. Read the topic .md file for step-by-step guidance
3. Consult detail files for specific subtopics (decorators, storage, types, etc.)
4. For language-agnostic content (CLI, ARC specs, general workflows), see the algorand-development parent skill