{"id":26123261,"url":"https://github.com/tiledesk/tiledesk-ai","last_synced_at":"2025-06-25T01:40:14.470Z","repository":{"id":102085533,"uuid":"530719900","full_name":"Tiledesk/tiledesk-ai","owner":"Tiledesk","description":"Tiledesk Module for Conversational AI. Tiledesk is an open source conversational platform alternative to Intercom, Zendesk, Drift, Tawk.to and Tidio for Customer Service and Conversational Marketing.","archived":false,"fork":false,"pushed_at":"2024-02-28T20:25:56.000Z","size":2966,"stargazers_count":12,"open_issues_count":0,"forks_count":9,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-27T05:23:02.201Z","etag":null,"topics":["chatbot","conversational-ai","open-source","python"],"latest_commit_sha":null,"homepage":"https://tiledesk.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Tiledesk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2022-08-30T15:33:40.000Z","updated_at":"2025-03-13T01:59:58.000Z","dependencies_parsed_at":"2023-03-10T00:30:45.227Z","dependency_job_id":"318f58d1-0d22-4f4c-9961-18a591f823d2","html_url":"https://github.com/Tiledesk/tiledesk-ai","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/Tiledesk%2Ftiledesk-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tiledesk%2Ftiledesk-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tiledesk%2Ftiledesk-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tiledesk%2Ftiledesk-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tiledesk","download_url":"https://codeload.github.com/Tiledesk/tiledesk-ai/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248725091,"owners_count":21151626,"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":["chatbot","conversational-ai","open-source","python"],"created_at":"2025-03-10T15:46:19.920Z","updated_at":"2025-04-13T14:20:58.884Z","avatar_url":"https://github.com/Tiledesk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tiledesk-ai\nTiledesk Module for AI\n\nThis module uses a simple Feed Forward Network implemented using PyTorch (more to come in the future) to understand the user intent.\n\n\n## Use with the command line\n\n\u003e NOTE: recommended Python version \u003e= 3.9\n\n### Install\n\nWe recommend to install a python3 virtual env and install tiledesk-ai on it.\n ```\n pip install virtualenv\n python3 -m venv tileai\n source ./tileai/bin/activate\n ```\n\nCreate your working folder:\n\n```\nmkdir tiledesk-ai\ncd tiledesk-ai\n```\n\nNow synchronize with the source repo:\n\n```\ngit clone https://github.com/Tiledesk/tiledesk-ai.git\ncd tiledesk-ai\npip install -r requirements.txt\n```\n\nNow you can choose between two alternatives.\n\n**PRODUCTION MODE**\n\nIf you are not interested in customize the code to improve/modify the module you can just\nuse the production command:\n\n\u003e pip install .\n\n\n**DEVELOPMENT MODE**\n\nFor developement (if you want to modify the source code), use:\n```\npip install -e .\n```\nThis command will install the in-place the program. You can edit the script files and test them from the command line.\n\n### Train\n\nUse the ./domain/**nlu.json** file to setup all intents train in your project.\n\n### nlu.json example\n\n```json\n{\n  \"configuration\": {\n    \"pipeline\": [\"auto\"]\n  },\n  \"nlu\": [\n    {\t\n      \"intent\":\"hello_intent\",\n      \"examples\":[\"Hi\",\"Hello\"]\n    },\n    {\t\n      \"intent\":\"goodbye_intent\",\n      \"examples\":[\"goodbye\",\"bye\",\"good night\"]\n    }\n  ]\n}\n```\n\nActually *configuration* parameter only takes this settings:\n\n```\n\"configuration\": {\n  \"pipeline\": \"auto|embeddingwbag|feedforward|lstm|bert\"\n}\n```\n\nTo **train the model** use the *tileai* command.\n\n*tileai* command synthax:\n\n```\n\u003e tileai train [-f nlu_filepath] [-o model_file_path]\n```\n\n*nlu_filepath* defaults to local */domain/nlu.json* file.\n\nExample:\n\n\u003e tileai train -f domain/nlu.json -o models/my_trained_model\n\n### Query\n\n```shell\n\u003e tileai query [-m model path] -t \"question\"\n```\n\nQuery example:\n\n```shell\n\u003e tileai query -m models/my_trained_model -t \"ciao\"\n```\n\n## HTTP server\n\n### Run the HTTP server\n\nYou can run the tiledesk-ai module as a web app, launching the HTTP server.\nDefault HTTP server port is 6006. You can change the port using the _-p port_ option.\n\n```shell\n\u003e tileai run [-p port]\n```\n\n### Query from HTTP server\nTo train your model from http server:\n```\nPOST http://localhost:port/train\n```\n```json\n{\n\t\"configuration\": {\n\t\t\"algo\": \"auto\"\n\t},\n\t\"nlu\": [{\t\n      \"intent\":\"hello_intent\",\n      \"examples\":[\"Hi\",\"Hello\", \"...\"]\n\t},\n\n\t]\n}\n```\n\nTo query your model\n```shell\nPOST http://localhost:port/model/parse\n```\n```json\n{\n\"model\":\"models/\u003cname of the model\u003e\",\n  \"text\":\"...\"\n}\n```\n\n## APIs\n\nTODO\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiledesk%2Ftiledesk-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftiledesk%2Ftiledesk-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiledesk%2Ftiledesk-ai/lists"}