This project provides a reverse-engineered Python API wrapper for Quora's Poe service, enabling access to various large language models like ChatGPT, GPT-4, and Claude. It is targeted at developers and power users who wish to integrate Poe's AI capabilities into their applications or workflows. The primary benefit is free access to these advanced models, though with potential risks.

How It Works

The API interacts with Poe's backend services by mimicking browser requests, requiring a user token for authentication. It supports sending messages, streaming responses, managing conversation history, creating and editing custom bots, and interacting with third-party bots. The library handles the underlying GraphQL queries and WebSocket communication necessary to interface with Poe.

Quick Start & Requirements

• Install via pip: pip3 install poe-api
• Requires quickjs and python-dev (or equivalent for macOS/Windows).
• Token acquisition involves inspecting browser cookies on poe.com.
• Examples are available in the /examples directory, runnable with python3 examples/temporary_message.py "TOKEN_HERE".

Highlighted Details

• Supports multiple LLMs including ChatGPT, GPT-4, and various Claude models.
• Allows creation, editing, and management of custom bots.
• Includes functionality for downloading conversation history and deleting messages.
• Offers proxy support and custom header/device ID configuration.

Maintenance & Community

This project is explicitly marked as UNMAINTAINED and does not currently work (as of the README's last update). Issue #231 contains further details.

Licensing & Compatibility

Licensed under the GNU General Public License v3.0. This is a copyleft license, meaning derivative works must also be licensed under GPLv3. Commercial use or linking with closed-source projects may be restricted due to the GPLv3 license.

Limitations & Caveats

The project is unmaintained and known to be non-functional. The README warns of potential account bans due to excessive usage and recommends using alt accounts. Installation may fail on Python 3.11 without proper python-dev setup.