Python SDK In Development

We're actively building the Python SDK. Star the repo on GitHub to get notified when it launches.

Python SDK

Build with Python

Official Python SDK for integrating Taxu into your Django, Flask, FastAPI, or any Python application.

Installation

Coming Soon: The taxu-python package will be available on PyPI. Follow progress on GitHub

pip

pip install taxu

Quick Start

import taxu

# Initialize client
client = taxu.Client(
    api_key="your_api_key",
    environment="production"  # or "sandbox"
)

# Estimate refund
estimate = client.refunds.estimate(
    income=75000,
    filing_status="single",
    deductions=["standard"]
)

print(f"Estimated refund: $" + str(estimate.amount))

Core Features

Tax Returns

# Create a new tax return
tax_return = client.returns.create(
    user_id="user_123",
    tax_year=2024,
    filing_status="married_jointly"
)

# Add income
client.returns.add_income(
    tax_return.id,
    type="W2",
    employer="Acme Corp",
    amount=85000
)

# File the return
filed = client.returns.file(tax_return.id)

Document Upload

# Upload and parse documents
with open("w2.pdf", "rb") as file:
    document = client.documents.upload(
        file=file,
        type="W2",
        return_id="ret_abc123"
    )

# Get parsed data
print(document.parsed)
# {'employer': 'Acme Corp', 'wages': 85000, ...}

Async/Await Support

import asyncio
from taxu import AsyncClient

async def main():
    client = AsyncClient(api_key="your_api_key")
    
    # All methods support async
    estimate = await client.refunds.estimate(
        income=75000,
        filing_status="single"
    )
    
    print(f"Refund: $" + str(estimate.amount))

asyncio.run(main())

Next Steps

API Reference

Complete documentation of all SDK methods

Example Apps

Full working examples on GitHub

Quick Start

import taxu

# Initialize client
client = taxu.Client(
    api_key="your_api_key",
    environment="production"  # or "sandbox"
)

# Estimate refund
estimate = client.refunds.estimate(
    income=75000,
    filing_status="single",
    deductions=["standard"]
)

print(f"Estimated refund: $" + str(estimate.amount))

Core Features

Tax Returns

# Create a new tax return
tax_return = client.returns.create(
    user_id="user_123",
    tax_year=2024,
    filing_status="married_jointly"
)

# Add income
client.returns.add_income(
    tax_return.id,
    type="W2",
    employer="Acme Corp",
    amount=85000
)

# File the return
filed = client.returns.file(tax_return.id)

Document Upload

# Upload and parse documents
with open("w2.pdf", "rb") as file:
    document = client.documents.upload(
        file=file,
        type="W2",
        return_id="ret_abc123"
    )

# Get parsed data
print(document.parsed)
# {'employer': 'Acme Corp', 'wages': 85000, ...}

Async/Await Support

import asyncio
from taxu import AsyncClient

async def main():
    client = AsyncClient(api_key="your_api_key")
    
    # All methods support async
    estimate = await client.refunds.estimate(
        income=75000,
        filing_status="single"
    )
    
    print(f"Refund: $" + str(estimate.amount))

asyncio.run(main())