Python Expert Agent for OpenCode

A comprehensive Python agentic tool for OpenCode with 10 skills, 4 subagents, and production-ready FastAPI patterns.

Note: This package is experimental and works great for local project-based use.

---

Why Use This?

Stop repeating yourself. This agent pack gives OpenCode deep Python expertise:

Before: Explain FastAPI patterns, Pydantic schemas, JWT auth, async database every time.

After:

skill(name="python-fastapi")
Create a login endpoint

---

Features

• 1 Primary Agent - python-expert with intelligent skill loading
• 4 Specialized Subagents - Code generation, review, testing, and exploration
• 10 On-Demand Skills - FastAPI, SQLAlchemy, pytest, asyncio, and more
• 4 Context Files - Standards, patterns, security, and navigation
• Production Ready - Targets Python 3.13+, FastAPI, Pydantic v2, SQLAlchemy 2.0

---

Installation

From npm (Recommended)

# Install globally
npm install -g python-expert-agent

# Install to current project
python-expert-agent init

# Install globally (for all projects, experimental)
python-expert-agent init --global

Using npx (No install needed)

npx python-expert-agent init

Manual Installation

Copy the .opencode directory and AGENTS.md to your project root.

---

Quick Start

# 1. Install the agent pack
npm install -g python-expert-agent
python-expert-agent init

# 2. Start OpenCode in your Python project
cd /path/to/your/python/project
opencode

# 3. The python-expert agent is automatically detected

# 4. Use skills on-demand
skill(name="python-fastapi")
skill(name="python-backend")

---

Common Use Cases

Create a REST API Endpoint

skill(name="python-fastapi")

Create a POST /api/users endpoint with:
- Email validation
- Password hashing (bcrypt)
- JWT token generation

Add Tests to Existing Code

skill(name="python-testing-general")

Write tests for src/services/user.py:
- Unit tests for create_user, get_user
- Mock the database
- Test edge cases (empty input, duplicates)