Konfuzio Software Development Kit
Project description
Konfuzio SDK
The Konfuzio Software Development Kit (Konfuzio SDK) provides a Python API to interact with the Konfuzio Server.
Features
The SDK allows you to retrieve visual and text features to build your own document models. Konfuzio Server serves as an UI to define the data structure, manage training/test data and to deploy your models as API.
Function | Public Host Free* | On-Site (Paid) |
---|---|---|
OCR Text | :heavy_check_mark: | :heavy_check_mark: |
OCR Handwriting | :heavy_check_mark: | :heavy_check_mark: |
Text Annotation | :heavy_check_mark: | :heavy_check_mark: |
PDF Annotation | :heavy_check_mark: | :heavy_check_mark: |
Image Annotation | :heavy_check_mark: | :heavy_check_mark: |
Table Annotation | :heavy_check_mark: | :heavy_check_mark: |
Download Images | :heavy_check_mark: | :heavy_check_mark: |
Download PDF with OCR | :heavy_check_mark: | :heavy_check_mark: |
Deploy AI models | :heavy_multiplication_x: | :heavy_check_mark: |
*
Under fair use policy: We will impose 10 pages/hour throttling eventually.
:ledger: Docs | Read the docs |
:floppy_disk: Installation | How to install the Konfuzio SDK |
:mortar_board: Tutorials | See what the Konfuzio SDK can do with our Notebooks & Scripts |
:bulb: Explanations | Here are links to teaching material about the Konfuzio SDK. |
:gear: API Reference | Python classes, methods, and functions |
:heart: Contributing | Learn how to contribute! |
:bug: Issue Tracker | Report and monitor Konfuzio SDK issues |
:telescope: Changelog | Review the release notes |
:newspaper: MIT License | Review the license |
Installation
As developer register on our public HOST for free: https://app.konfuzio.com
Then you can use pip to install Konfuzio SDK and run init:
pip install konfuzio_sdk
konfuzio_sdk init
The init will create a Token to connect to the Konfuzio Server. This will create variables KONFUZIO_USER
,
KONFUZIO_TOKEN
and KONFUZIO_HOST
in an .env
file in your working directory.
By default, the SDK is installed without the AI-related dependencies like torch
or transformers
and allows for using
only the Data-related SDK concepts but not the AI models. To install the SDK with the AI components,
run the following command:
pip install konfuzio_sdk[ai]
Find the full installation guide here or setup PyCharm as described here.
CLI
We provide the basic function to create a new Project via CLI:
konfuzio_sdk create_project YOUR_PROJECT_NAME
You will see "Project {YOUR_PROJECT_NAME}
(ID {YOUR_PROJECT_ID}
) was created successfully!" printed.
And download any project via the id:
konfuzio_sdk export_project YOUR_PROJECT_ID
Tutorials
You can find detailed examples about how to set up and run document AI pipelines in our Tutorials, including:
- Split a file into separate Documents
- Document Categorization
- Train a Konfuzio SDK Model to Extract Information From Payslip Documents
Basics
Here we show how to use the Konfuzio SDK to retrieve data hosted on a Konfuzio Server instance.
from konfuzio_sdk.data import Project, Document
# Initialize the Project
YOUR_PROJECT_ID: int
my_project = Project(id_=YOUR_PROJECT_ID)
# Get any Document online
DOCUMENT_ID_ONLINE: int
doc: Document = my_project.get_document_by_id(DOCUMENT_ID_ONLINE)
# Get the Annotations in a Document
doc.annotations()
# Filter Annotations by Label
MY_OWN_LABEL_NAME: str
label = my_project.get_label_by_name(MY_OWN_LABEL_NAME)
doc.annotations(label=label)
# Or get all Annotations that belong to one Category
YOUR_CATEGORY_ID: int
category = my_project.get_category_by_id(YOUR_CATEGORY_ID)
label.annotations(categories=[category])
# Force a Project update. To save time Documents will only be updated if they have changed.
my_project.get(update=True)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file konfuzio_sdk-0.2.47.dev20240322171047.tar.gz
.
File metadata
- Download URL: konfuzio_sdk-0.2.47.dev20240322171047.tar.gz
- Upload date:
- Size: 213.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 324a727d148e31f75dd4d079752fb944794ec18da3e8b4657ef45720387f8ac0 |
|
MD5 | 5f93954657f93b883cd86f59de9f1565 |
|
BLAKE2b-256 | 2574f5bf4dba434e4d72cdf2ee904c262ce5f4af3c65cae19ca370aec515ea89 |
File details
Details for the file konfuzio_sdk-0.2.47.dev20240322171047-py3-none-any.whl
.
File metadata
- Download URL: konfuzio_sdk-0.2.47.dev20240322171047-py3-none-any.whl
- Upload date:
- Size: 164.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d6d2a1a46912644c5c1049f30f17b11e609bb6acae4894694082636cbec3ba37 |
|
MD5 | 99f11037ff185b8eae3fdee8f6aa1ed0 |
|
BLAKE2b-256 | e6c92cc33b88d51f73483eb09e0f30568c2a894e875dc743e35057acca65e0f5 |