Skip to content

Virginia Clemm Poe Documentation

TLDR

Virginia Clemm Poe is a Python package that provides programmatic access to comprehensive Poe.com model data with pricing information. It acts as a companion tool to the official Poe API by fetching, maintaining, and enriching model data through web scraping, with a special focus on capturing detailed pricing information not available through the API alone.

Key Features: - 🤖 Comprehensive Model Data: Access to all Poe.com models with detailed metadata - 💰 Pricing Information: Automatically scraped pricing data for all operations - 🐍 Python API: Clean, typed API for programmatic access - 🖥️ CLI Interface: Fire-based command-line tools for data management - 🌐 Web Scraping: Playwright-powered browser automation for reliable data extraction - 📊 Pydantic Models: Fully typed data structures for easy integration

Table of Contents

Getting Started

  1. Introduction and Overview - Learn about the package's purpose, architecture, and core concepts
  2. Installation and Setup - Step-by-step installation guide and initial configuration
  3. Quick Start Guide - Get up and running with basic examples and common use cases

Usage Guides

  1. Python API Reference - Complete Python API documentation with examples
  2. CLI Usage and Commands - Command-line interface reference and usage patterns
  3. Data Models and Structure - Understanding the data structures and Pydantic models

Advanced Topics

  1. Browser Management and Web Scraping - Deep dive into web scraping functionality and browser automation
  2. Configuration and Advanced Usage - Advanced configuration options and customization
  3. Troubleshooting and FAQ - Common issues, solutions, and frequently asked questions

Quick Example

from virginia_clemm_poe import api

# Search for Claude models
claude_models = api.search_models(query="claude")

# Get specific model with pricing
model = api.get_model_by_id("claude-3-opus")
if model.pricing:
    print(f"Input cost: {model.pricing.details['Input (text)']}")

# List all available models
all_models = api.list_models()
print(f"Total models available: {len(all_models)}")

CLI Quick Start

# Setup browser for web scraping
virginia-clemm-poe setup

# Update model data with pricing
POE_API_KEY=your_key virginia-clemm-poe update --pricing

# Search for models
virginia-clemm-poe search "gpt-4"

Named after Edgar Allan Poe's wife and cousin, Virginia Clemm Poe, this package serves as a faithful companion to the Poe platform, just as she was to the great poet.