PySequence

Unofficial Python SDK for the GetSequence personal finance platform.

Overview

PySequence is a toolkit, not a monolith. Pick what you need:

• SDK only -- Import pysequence-sdk into your own Python project and talk to the Sequence GraphQL API directly. No server, no bot, no Docker.
• API server -- A REST trust boundary for external services. Sits in front of the SDK with API-key auth and transfer safeguards.
• Telegram bot -- AI-powered personal finance assistant using Claude. Uses the SDK directly with its own safeguards (daily limits, audit trail, transfer confirmation).

Each component is independently deployable.

Packages

Package	Description	PyPI
pysequence-sdk	Core GraphQL SDK
pysequence-api	FastAPI REST server
pysequence-client	HTTP client for the REST API
pysequence-bot	Telegram bot with AI agent

Architecture

pysequence-client --> (HTTP) --> pysequence-api --> pysequence-sdk --> (GraphQL) --> Sequence.io
                                                        ^
                                  pysequence-bot -------/

Quick Start

SDK

pip install pysequence-sdk

from pysequence_sdk import SequenceClient, get_access_token

token = get_access_token()
with SequenceClient(token) as client:
    pods = client.get_pods()
    balance = client.get_total_balance()

API Server

just api-up

Telegram Bot

just bot-up

HTTP Client

pip install pysequence-client

from pysequence_client import SequenceApiClient

client = SequenceApiClient(
    base_url="http://localhost:8720",
    api_key="your-api-key",
)

pods = client.get_pods()
balance = client.get_total_balance()

Documentation

• SDK Reference
• API Server
• HTTP Client
• Telegram Bot
• Configuration
• Docker
• Development

License

MIT