reverse-engineered chatgpt web interface access via tls interception
Implements direct HTTP client access to ChatGPT's web interface by circumventing Cloudflare protection through TLS-based request spoofing and session management. The V1 API constructs authenticated requests that mimic browser behavior, handling cookie persistence, CSRF tokens, and Cloudflare challenge responses to maintain stateful conversations without relying on OpenAI's official API endpoints. This approach enables free access to ChatGPT models by reusing existing web session credentials.
Unique: Implements TLS-based session hijacking with Cloudflare challenge handling and browser-like request spoofing, allowing free ChatGPT access without official API keys. Uses configurable proxy servers and custom User-Agent rotation to evade detection.
vs alternatives: Enables free ChatGPT access unlike official API, but trades reliability and legality for cost savings — best for non-production prototypes only.
official openai api wrapper with conversation state management
Provides a structured Python wrapper around OpenAI's official ChatGPT API (gpt-3.5-turbo, gpt-4) with built-in conversation history management, automatic context truncation, and streaming response handling. The V3 API maintains conversation state in memory or via external storage, automatically manages token limits by truncating older messages, and abstracts away raw API request/response formatting. This enables developers to build multi-turn conversational applications without manually managing conversation context or token counting.
Unique: Wraps OpenAI's official API with automatic conversation state management and token-aware context truncation, abstracting away manual message history and token counting. Supports both synchronous and asynchronous interfaces with streaming response handling.
vs alternatives: More reliable and production-ready than reverse-engineered V1 API, but requires paid API keys — best for applications where cost is acceptable and reliability is critical.
conversation threading and message id tracking
Implements conversation threading using message IDs and parent IDs to track conversation structure and enable branching conversations. Each message has a unique ID and references a parent message ID, allowing the system to reconstruct conversation trees and support multiple conversation branches from a single parent. This enables features like conversation forking, editing previous messages, and exploring alternative conversation paths. The system tracks conversation IDs for grouping related messages.
Unique: Implements message ID and parent ID tracking to support conversation branching and threading, enabling users to explore alternative conversation paths. Unique to V1 API.
vs alternatives: Enables advanced conversation features (branching, editing) not available in simple linear chat interfaces.
proxy and network configuration for restricted environments
Supports configurable HTTP/HTTPS proxies and custom network settings for accessing ChatGPT in restricted network environments (corporate firewalls, VPNs, etc.). The system accepts proxy URLs in configuration, passes them to the underlying HTTP client (requests for sync, aiohttp for async), and handles proxy authentication. This enables the library to work in environments where direct internet access is blocked or monitored. Both V1 and V3 APIs support proxy configuration.
Unique: Supports configurable HTTP/HTTPS proxies with authentication for both sync and async HTTP clients, enabling use in restricted network environments. Configuration via YAML or environment variables.
vs alternatives: Enables ChatGPT access in corporate/restricted networks where direct access is blocked, unlike cloud-only solutions.
dual-mode authentication with email/password and access token support
Implements flexible authentication for the V1 reverse-engineered API supporting both email/password login and direct access token injection. The system handles OpenAI's authentication flow including optional captcha solving via external services (2captcha, hcaptcha), session token refresh, and credential validation. For V3, it accepts OpenAI API keys directly. This abstraction allows developers to choose authentication method based on their security posture and automation requirements.
Unique: Supports both email/password and access token authentication for V1 with integrated captcha solver support, plus API key auth for V3. Abstracts credential handling across two fundamentally different authentication paradigms (web session vs API key).
vs alternatives: More flexible than official API (which only accepts API keys) by supporting multiple auth methods, but adds complexity and security risk compared to standard API key authentication.
plugin system for extending chatgpt capabilities
Implements a plugin architecture (V1 only) that allows ChatGPT to invoke external tools and services during conversation. The system maintains a plugin registry loaded from configuration, detects when the model requests plugin execution, and routes requests to appropriate plugin handlers. Plugins can be web APIs, local functions, or external services — the framework handles serialization, error handling, and response injection back into the conversation context. This enables ChatGPT to perform actions beyond text generation (web search, calculations, database queries).
Unique: Provides a plugin registry and execution framework that detects when ChatGPT requests tool invocation and routes to external handlers, enabling agentic behavior. Unique to V1 reverse-engineered API — not available in official V3 API.
vs alternatives: Enables tool use on V1 API before OpenAI added function calling to official API, but less reliable than modern function-calling APIs due to model training differences.
streaming response handling with real-time token delivery
Implements streaming response processing for both V1 and V3 APIs, delivering model output tokens in real-time as they are generated rather than waiting for complete response. The system parses server-sent events (SSE) or chunked HTTP responses, extracts individual tokens, and yields them to the caller. This enables responsive user interfaces with progressive text rendering, reduced perceived latency, and better user experience in web/mobile applications. Supports both synchronous iteration and asynchronous streaming.
Unique: Implements streaming for both reverse-engineered V1 API and official V3 API with unified interface, handling SSE parsing and token extraction. Supports both sync and async iteration patterns.
vs alternatives: Provides streaming across both API versions with consistent interface, whereas most libraries only support streaming for official APIs.
asynchronous api with asyncio support for concurrent operations
Provides fully asynchronous Python interfaces (using asyncio) for both V1 and V3 APIs, enabling concurrent ChatGPT requests without blocking. The implementation uses async/await patterns, aiohttp for HTTP requests, and async generators for streaming responses. This allows developers to build high-concurrency applications that can handle multiple conversations simultaneously without thread overhead. Both APIs expose async variants of all core methods.
Unique: Provides complete async/await interfaces for both V1 and V3 APIs with aiohttp-based HTTP client, enabling true concurrent ChatGPT access without threading. Async generators support streaming in async contexts.
vs alternatives: Enables high-concurrency applications better than synchronous-only libraries, but requires async framework integration and asyncio expertise.
+4 more capabilities