{"id":46218916,"url":"https://github.com/kili-technology/kili-python-sdk","last_synced_at":"2026-04-02T14:02:12.310Z","repository":{"id":37428312,"uuid":"195062961","full_name":"kili-technology/kili-python-sdk","owner":"kili-technology","description":"Simplest and fastest image and text annotation tool.","archived":false,"fork":false,"pushed_at":"2026-03-26T21:18:30.000Z","size":816865,"stargazers_count":233,"open_issues_count":15,"forks_count":29,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-03-27T03:29:33.478Z","etag":null,"topics":["annotation","annotation-tool-offline","annotation-tool-online","bounding-box","computer-vision-annotation-tool","data-annotations","document-annotation-tool","image-annotation-tool","image-labeling","image-texte-video-classification","labeling","labeling-tool","semantic-annotation","semantic-segmentation","text-annotation-tool","text-labeling","texte-video-classification","video-classification"],"latest_commit_sha":null,"homepage":"https://kili-technology.com","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kili-technology.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-07-03T13:49:30.000Z","updated_at":"2026-03-25T16:52:56.000Z","dependencies_parsed_at":"2023-10-16T09:10:37.966Z","dependency_job_id":"e902e683-2a8a-4d1c-ad0d-0c142adc1d1c","html_url":"https://github.com/kili-technology/kili-python-sdk","commit_stats":{"total_commits":2231,"total_committers":75,"mean_commits":"29.746666666666666","dds":0.8314657104437472,"last_synced_commit":"457b5fcbeb5ca524682eeef2b6f81a0b3cd12178"},"previous_names":["kili-technology/kili-playground"],"tags_count":294,"template":false,"template_full_name":null,"purl":"pkg:github/kili-technology/kili-python-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kili-technology%2Fkili-python-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kili-technology%2Fkili-python-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kili-technology%2Fkili-python-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kili-technology%2Fkili-python-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kili-technology","download_url":"https://codeload.github.com/kili-technology/kili-python-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kili-technology%2Fkili-python-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31307462,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["annotation","annotation-tool-offline","annotation-tool-online","bounding-box","computer-vision-annotation-tool","data-annotations","document-annotation-tool","image-annotation-tool","image-labeling","image-texte-video-classification","labeling","labeling-tool","semantic-annotation","semantic-segmentation","text-annotation-tool","text-labeling","texte-video-classification","video-classification"],"created_at":"2026-03-03T11:11:51.317Z","updated_at":"2026-04-02T14:02:12.300Z","avatar_url":"https://github.com/kili-technology.png","language":"Jupyter Notebook","readme":"# Kili Python SDK\n\n[![Python 3.10](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white)](https://github.com/pre-commit/pre-commit)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/kili-technology/kili-python-sdk?label=pypi%20package)\n\n---\n\n**SDK Reference**: \u003chttps://python-sdk-docs.kili-technology.com/\u003e\n\n**Kili Documentation**: \u003chttps://docs.kili-technology.com/docs\u003e\n\n**App**: \u003chttps://cloud.kili-technology.com/label/\u003e\n\n**Website**: \u003chttps://kili-technology.com/\u003e\n\n---\n\n## What is Kili?\n\nKili is a platform that empowers a data-centric approach to Machine Learning through quality training data creation. It provides collaborative data **annotation tools** and APIs that enable quick iterations between reliable dataset building and model training. More info [here](https://kili-technology.com/platform/label-annotate).\n\n### Annotation tools examples\n\n|                                      Named Entities Extraction and Relation                                      |                                   PDF classification and bounding-box                                   |                                     Object detection (bounding-box)                                      |\n| :--------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------: |\n| ![](https://raw.githubusercontent.com/kili-technology/kili-python-sdk/main/recipes/img/relations-extraction.png) | ![](https://raw.githubusercontent.com/kili-technology/kili-python-sdk/main/recipes/img/pdf_classif.png) | ![](https://raw.githubusercontent.com/kili-technology/kili-python-sdk/main/recipes/img/bounding-box.jpg) |\n\nand [many more](https://docs.kili-technology.com/docs/labeling-overview).\n\n## What is Kili Python SDK?\n\n**Kili Python SDK** is the Python client for the Kili platform. It allows to query and manipulate the main entities available in Kili, like projects, assets, labels, api keys...\n\nIt comes with several [tutorials](https://python-sdk-docs.kili-technology.com/latest/sdk/tutorials/basic_project_setup/) that demonstrate how to use it in the most frequent use cases.\n\n## Requirements\n\n- Python \u003e= 3.10\n- Create and copy a [Kili API key](https://docs.kili-technology.com/docs/creating-an-api-key)\n- Add the `KILI_API_KEY` variable in your bash environment (or in the settings of your favorite IDE) by pasting the API key value you copied above:\n\n```bash\nexport KILI_API_KEY='\u003cyour api key value here\u003e'\n```\n\n## Installation\n\nInstall the Kili client with pip:\n\n```bash\npip install kili\n```\n\nIf you want to contribute, here are the [installation steps](CONTRIBUTING.md).\n\n## Usage\n\nInstantiate the Kili client:\n\n```python\nfrom kili.client import Kili\nkili = Kili()\n# You can now use the Kili client!\n```\n\nNote that you can also pass the API key as an argument of the `Kili` initialization:\n\n```python\nkili = Kili(api_key='\u003cyour api key value here\u003e')\n```\n\nFor more details, read the [SDK reference](https://python-sdk-docs.kili-technology.com) or the [Kili documentation](https://docs.kili-technology.com/docs).\n\n## Tutorials\n\nCheck out our [tutorials](https://python-sdk-docs.kili-technology.com/latest/tutorials)! They will guide you through the main features of the Kili client.\n\nYou can find several other recipes in this [folder](https://github.com/kili-technology/kili-python-sdk/tree/main/recipes).\n\n## Examples\n\nHere is a sample of the operations you can do with the Kili client:\n\n### Creating an annotation project\n\n```python\njson_interface = {\n    \"jobs\": {\n        \"CLASSIFICATION_JOB\": {\n            \"mlTask\": \"CLASSIFICATION\",\n            \"content\": {\n                \"categories\": {\n                    \"RED\": {\"name\": \"Red\"},\n                    \"BLACK\": {\"name\": \"Black\"},\n                    \"WHITE\": {\"name\": \"White\"},\n                    \"GREY\": {\"name\": \"Grey\"}},\n                \"input\": \"radio\"\n            },\n            \"instruction\": \"Color\"\n        }\n    }\n}\nproject_id = kili.create_project(\n    title=\"Color classification\",\n    description=\"Project \",\n    input_type=\"IMAGE\",\n    json_interface=json_interface\n)[\"id\"]\n```\n\n### Importing data to annotate\n\n```python\nassets = [\n    {\n        \"externalId\": \"example 1\",\n        \"content\": \"https://images.caradisiac.com/logos/3/8/6/7/253867/S0-tesla-enregistre-d-importantes-pertes-au-premier-trimestre-175948.jpg\",\n    },\n    {\n        \"externalId\": \"example 2\",\n        \"content\": \"https://img.sportauto.fr/news/2018/11/28/1533574/1920%7C1280%7Cc096243e5460db3e5e70c773.jpg\",\n    },\n    {\n        \"externalId\": \"example 3\",\n        \"content\": \"./recipes/img/man_on_a_bike.jpeg\",\n    },\n]\n\nexternal_id_array = [a.get(\"externalId\") for a in assets]\ncontent_array = [a.get(\"content\") for a in assets]\n\nkili.append_many_to_dataset(\n    project_id=project_id,\n    content_array=content_array,\n    external_id_array=external_id_array,\n)\n```\n\nSee the detailed example in this [tutorial](https://python-sdk-docs.kili-technology.com/latest/sdk/tutorials/importing_assets_and_metadata/).\n\n### Importing predictions\n\n```python\nprediction_examples = [\n    {\n        \"external_id\": \"example 1\",\n        \"json_response\": {\n            \"CLASSIFICATION_JOB\": {\n                \"categories\": [{\"name\": \"GREY\", \"confidence\": 46}]\n            }\n        },\n    },\n    {\n        \"external_id\": \"example 2\",\n        \"json_response\": {\n            \"CLASSIFICATION_JOB\": {\n                \"categories\": [{\"name\": \"WHITE\", \"confidence\": 89}]\n            }\n        },\n    }\n]\n\nkili.create_predictions(\n    project_id=project_id,\n    external_id_array=[p[\"external_id\"] for p in prediction_examples],\n    json_response_array=[p[\"json_response\"] for p in prediction_examples],\n    model_name=\"My SOTA model\"\n)\n```\n\nSee detailed examples in this [recipe](https://docs.kili-technology.com/recipes/importing-labels-and-predictions).\n\n### Exporting labels\n\n```python\nkili.export_labels(\"your_project_id\", \"export.zip\", \"yolo_v4\")\n```\n\nSee a detailed example in this [tutorial](https://python-sdk-docs.kili-technology.com/latest/sdk/tutorials/export_a_kili_project/).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkili-technology%2Fkili-python-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkili-technology%2Fkili-python-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkili-technology%2Fkili-python-sdk/lists"}