{"id":18575048,"url":"https://github.com/mirusu400/clova-x","last_synced_at":"2025-12-14T08:37:33.376Z","repository":{"id":190356209,"uuid":"682442797","full_name":"mirusu400/CLOVA-X","owner":"mirusu400","description":"Unofficial API for CLOVA X","archived":false,"fork":false,"pushed_at":"2023-12-27T17:16:50.000Z","size":30,"stargazers_count":35,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-30T00:47:03.771Z","etag":null,"topics":["api","clova","clovaai","hacktoberfest","llm","naver","naver-api","nlp"],"latest_commit_sha":null,"homepage":"","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/mirusu400.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":"2023-08-24T07:15:55.000Z","updated_at":"2024-04-18T03:08:21.000Z","dependencies_parsed_at":"2024-11-06T23:17:32.599Z","dependency_job_id":"7177be0d-115b-431e-8a99-4d6d4d9dadc4","html_url":"https://github.com/mirusu400/CLOVA-X","commit_stats":null,"previous_names":["mirusu400/clova-x","mirusu400/clova-x-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirusu400%2FCLOVA-X","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirusu400%2FCLOVA-X/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirusu400%2FCLOVA-X/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirusu400%2FCLOVA-X/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mirusu400","download_url":"https://codeload.github.com/mirusu400/CLOVA-X/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248185188,"owners_count":21061469,"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":["api","clova","clovaai","hacktoberfest","llm","naver","naver-api","nlp"],"created_at":"2024-11-06T23:17:24.064Z","updated_at":"2025-10-28T05:11:44.124Z","avatar_url":"https://github.com/mirusu400.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Naver Clova X Unofficial API\r\n\r\n\r\n![clova-logo](https://raw.githubusercontent.com/mirusu400/CLOVA-X/main/doc/clova-logo.png)\r\n\r\n\u003ca href=\"https://pypi.org/project/clovax/\"\u003e\u003cimg alt=\"PyPI package\" src=\"https://img.shields.io/badge/pypi-clovax-green\"\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/mirusu400/CLOVA-X/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/mirusu400/CLOVA-X?style=social\"\u003e\u003c/a\u003e\r\n\u003ca href=\"https://pypi.org/project/clovax/\"\u003e\u003cimg alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/clovax\"\u003e\u003c/a\u003e\r\n\r\nUnofficial API for Naver Clova X, a Korean AI LLM (Language Model) service.\r\n\r\n## Install\r\n\r\n```\r\npip install clovax\r\n```\r\n\r\n## How can I get cookie file?\r\n\r\n1. Install [Get cookies.txt LOCALLY](https://chrome.google.com/webstore/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)\r\n2. Export cookie\r\n3. Set cookie file path to `get_cookie` function\r\n\r\n## Usage\r\n**Start a conversation**\r\n```python\r\nfrom clovax import ClovaX\r\n\r\nc = ClovaX()\r\nc.get_cookie(\"[Your netscape cookie file]\")\r\nlog = c.start(\"Hello world!\")\r\nprint(log[\"text\"])\r\n```\r\n\r\n**Continue a conversation**\r\n```python\r\nfrom clovax import ClovaX\r\n\r\nc = ClovaX()\r\nc.get_cookie(\"[Your netscape cookie file]\")\r\nlog = c.start(\"Hello world!\")\r\nprint(log[\"text\"])\r\n# At this time, you can continue the conversation using existed session (conversation ID)\r\nlog = c.conversation(\"Who are you?\")\r\nprint(log[\"text\"])\r\n```\r\n\r\n**Regenerate a conversation**\r\n```python\r\nfrom clovax import ClovaX\r\n\r\nc = ClovaX()\r\nc.get_cookie(\"[Your netscape cookie file]\")\r\nlog = c.start(\"Hello world!\")\r\nlog = c.regenerate()\r\nprint(log[\"text\"])\r\n```\r\n\r\n**Conversation with a skillset**\r\n```python\r\nfrom clovax import ClovaX\r\nimport json\r\n\r\nc = ClovaX()\r\nc.get_cookie(\"clova-x.naver.com_cookies.txt\")\r\nlog = c.start(\"가을에 입을만한 바지 추천해 줘\", skillsets=[\"shopping\", \"travel\"])\r\nwith open(\"./test.html\", \"w\", encoding=\"utf-8\") as f:\r\n    f.write(log[\"contents\"][1][\"content\"])\r\nprint(log[\"text\"])\r\n```\r\n\r\n\r\n\r\n\r\n## TODO\r\n\r\n* [ ] Login using given naver ID and password\r\n* [ ] Get existed conversation using conversation ID\r\n* [ ] Proxy support\r\n* [ ] Support personas\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirusu400%2Fclova-x","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmirusu400%2Fclova-x","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirusu400%2Fclova-x/lists"}