Awesome Open Source
Awesome Open Source

PyPI version Build Status codecov

Sypht Python Client

This repository is a Python 3+ reference client implementation for the Sypht API at

About Sypht

Sypht is a SaaS API which extracts key fields from documents and images.

For example, you can upload an image or pdf of a bill or invoice and extract the amount due, due date, invoice number and biller information.

For an up-to-date list of supported extraction types, see the Marketplace.

Getting started

To get started you'll need API credentials, i.e. a <client_id> and <client_secret>, which can be obtained by registering for an account


Latest version is available via pypi:

pip install sypht


from sypht.client import SyphtClient

sc = SyphtClient('<client_id>', '<client_secret>')

with open('invoice.png', 'rb') as f:
    fid = sc.upload(f, products=["forms-&-reports"])


or run it via the command line:

export SYPHT_API_KEY="<client_id>:<client_secret>"
sypht extract --product invoices path/to/your/document.pdf


Visit the Marketplace to see the full set of available AI Products, document types and data fields supported.

Advanced workflows, features and field data structures are covered in the Dev Guide.


The software in this repository is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (1,143,903
Python3 (33,410
Api Client (2,943
Extract (426
Invoice (377
Information Extraction (289
Data Extraction (128
Python3 Library (55
Pdf Parser (34
Receipt Scanner (12
Invoice Parser (11
Extract Data From Pdf (9
Receipt Capture (9
Receipt Scanning (9
Document Capture (8
Extract Fields (8
Receipt Reader (8
Sypht (8
Sypht Api (8
Related Projects