{"id":20489413,"url":"https://github.com/f1uctus/ttc","last_synced_at":"2025-04-13T16:32:52.765Z","repository":{"id":40760218,"uuid":"330003940","full_name":"F1uctus/ttc","owner":"F1uctus","description":"✍ 🗣 A Text-To-Conversation natural language processing toolkit [WIP].","archived":false,"fork":false,"pushed_at":"2024-09-16T17:52:00.000Z","size":2297,"stargazers_count":4,"open_issues_count":3,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-09-16T22:00:09.926Z","etag":null,"topics":["conversation","nlp","nlp-apis","nlp-library","spacy","spacy-extension","spacy-nlp","spacy-pipeline","speaker-identification"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/F1uctus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-15T19:30:27.000Z","updated_at":"2024-09-16T17:51:57.000Z","dependencies_parsed_at":"2023-02-10T09:01:25.513Z","dependency_job_id":"e802a19b-280f-4e67-b886-300db30dd582","html_url":"https://github.com/F1uctus/ttc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F1uctus%2Fttc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F1uctus%2Fttc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F1uctus%2Fttc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F1uctus%2Fttc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/F1uctus","download_url":"https://codeload.github.com/F1uctus/ttc/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248743995,"owners_count":21154784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["conversation","nlp","nlp-apis","nlp-library","spacy","spacy-extension","spacy-nlp","spacy-pipeline","speaker-identification"],"created_at":"2024-11-15T17:12:50.607Z","updated_at":"2025-04-13T16:32:52.742Z","avatar_url":"https://github.com/F1uctus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Text-To-Conversation toolkit (TTC)\n\nThis NLP library can help you with:\n\n- Extraction of characters' replicas from literary texts;\n- Identification of the actors owning these replicas.\n\n### Demo (CLI)\n\n![](assets/demo-cli.png)\n\n### Progress\n\nWe aim to achieve the following goals:\n\n- Better accuracy on the actor classification task\n  (it is near 80% or worse for now);\n- Support for more languages\n  (only Russian is supported at the moment).\n\n### Installation\n\nInstall with pip is just a usual `pip install .` from the project dir.\n\n### Usage\n\n**As a library**\n\nYou can find an example of using the library in the [`cli.py`](ttc/cli.py) file.\n\n**As a tool for the CLI**\n\nTest output on a text file:\n\n```console\nttc print-play path-to-the-text-file text-language\n```\n\n**Notes**\n\n- Text must be encoded in UTF-8;\n- Text must be sanitized (see https://github.com/F1uctus/ttc/issues/23);\n- It is usually better to test on some middle-sized text (e.g a book chapter);\n- Supported `text-language`s are:\n    + ru (russian)\n\n### Development\n\nPlease install [Poetry](https://python-poetry.org).\n\nSpawn a new virtual environment for the project:\n\n```console\npoetry shell\n```\n\nInstall project dependencies:\n\n```console\npoetry install [--with dev,large_models_ru]\n```\n\nContributions are very welcome!\n\n#### Implementation notes\n\n[russian/*/actor_classifier.py](ttc/language/russian/pipelines/actor_classifier.py):\n![](http://www.plantuml.com/plantuml/svg/ZLLHYzf047xVNp5SNxIWnTAZ89vSMoeSs4FmqHD9udWknjsmMTlQMkWFw6DV--VkbtGdkycOfENqGMTsltpVV3DClCrjPEnXdugjN2FWFhD7M6EU69bPgPN8Tr9baOdsa4g5zfWXQ6EtMfpTE0wBy5q0JBIoS_aDOV0sPFVH7aUZJrhfyHW-w8EHQCGF8QoqAKAIHdakDyTLb5XjSY4MBvVGwurXgdKcFE_LdKL3GNm4wyfACR-2AFSG-e8XzFjzM6G6FozzQ31BPHA5JE5NMuIYf2He7zLwHQRW1WA-NtIZE2mavgxuAI5UO1nVNx_nSgw-wgPYdB7cy0PclfY2PEQYUROJvIFqV7KOVjbpoVSWHl4O03eh687i3RfmOfVGWq5XQFGg7Z-e0jifGFGvqUbvInRJoJAWe2C9nB2ddx-vNHufVDce3gc5SdPL2ne-F6e8Jtz-_QSNJdN6LPDemV_E3VvH-UT5e27A-iLvqcwIyqZqYw6hl1YTL8-50bloMXkBPXu0bHDcRG2USPDZP99jfnJiDYoLDA9EojOOK4lRzbYOJBf9EPkerWxh9rK9lyUDDlYHhjXUMvvX5viakRR5G24gGZR8ruAJIyr9bQEXruwBwOHam_gU-RmhKPNLPXqju6LcA_ccNoOI3MPspI3HoDlUouLztMqjAuMrZJx18aRx1L7nq0C0Q9kVt-H9bAPnbEpQk_mFCuo-h6U-jbR7IXPH1jmelgkdhJOrDE-rmk17fdLUEWdrKiXC_C9sVopY5jNwi4__0W00)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff1uctus%2Fttc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff1uctus%2Fttc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff1uctus%2Fttc/lists"}