{"id":30188353,"url":"https://github.com/inferixon/inferanki","last_synced_at":"2026-05-07T15:38:19.919Z","repository":{"id":308346473,"uuid":"1032489577","full_name":"inferixon/InferAnki","owner":"inferixon","description":"Norwegian Language Learning Add-on for Anki with AI-powered features","archived":false,"fork":false,"pushed_at":"2025-08-30T08:02:30.000Z","size":564,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-30T10:07:38.434Z","etag":null,"topics":["ai-based","anki","anki-addon","elevenlabs","elevenlabs-api-integration","language-learning","language-learning-tool","norwegian","openai","openai-chatgpt","tts"],"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/inferixon.png","metadata":{"files":{"readme":"README-uk.md","changelog":"changelog.md","contributing":"CONTRIBUTING.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-05T11:34:23.000Z","updated_at":"2025-08-30T08:02:33.000Z","dependencies_parsed_at":"2025-08-05T13:27:55.295Z","dependency_job_id":"245a107d-1a14-4c9c-9030-b26073dd0729","html_url":"https://github.com/inferixon/InferAnki","commit_stats":null,"previous_names":["inferixon/inferanki"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/inferixon/InferAnki","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inferixon%2FInferAnki","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inferixon%2FInferAnki/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inferixon%2FInferAnki/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inferixon%2FInferAnki/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/inferixon","download_url":"https://codeload.github.com/inferixon/InferAnki/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inferixon%2FInferAnki/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002538,"owners_count":26083400,"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","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai-based","anki","anki-addon","elevenlabs","elevenlabs-api-integration","language-learning","language-learning-tool","norwegian","openai","openai-chatgpt","tts"],"created_at":"2025-08-12T17:00:56.348Z","updated_at":"2026-05-07T15:38:19.911Z","avatar_url":"https://github.com/inferixon.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# InferAnki v0.6.7\n\n**Додаток для Anki на базі штучного інтелекту для допомоги у вивченні норвезької мови**\n\n## Що таке Anki?\n\n**Anki** – це **безкоштовна** програма для створення та вивчення флешкарток, що використовує принцип **інтервального повторення**. Це один із найефективніших методів запам'ятовування інформації, науково підтверджений дослідженнями когнітивної психології.\n\n**Офіційний сайт**: https://apps.ankiweb.net/\n\nAnki доступна як на комп'ютері, так і на смартфоні — можна вчитися будь-де, а прогрес синхронізується через хмару.\n\n### Наукове обґрунтування\n\n**Крива забування Еббінгауза** (1885) показує, як швидко ми втрачаємо нову інформацію.\n\nБез повторення ми забуваємо:\n- **50%** інформації за 20 хвилин\n- **70%** – за день\n- **90%** – за тиждень\n\n**Інтервальне повторення** змінює цю картину: повторюючи матеріал у оптимальні проміжки часу, ми переводимо інформацію з короткочасної пам’яті в довготривалу з мінімальними зусиллями.\n\n### Як працює Anki?\n\nAnki обчислює **оптимальні інтервали повторення** для кожної картки. Користувач сам оцінює складність пригадування картки після показу, а програма автоматично визначає дату наступного повторення:\n- «Легкі» картки відкладаються на довший термін.\n- «Складні» повторюються частіше.\n\nСистема адаптується під ваш темп навчання.\n\n**Результат:** замість механічного зазубрювання ви запам'ятовуєте матеріал ефективно та надовго, витрачаючи 15–20 хвилин на день.\n\n### Чому Anki + InferAnki?\n\nInferAnki додає до функціоналу Anki **потужність штучного інтелекту**. Це чотири кнопки на панелі інструментів у редакторі карток:\n\n- ✨ **CardCraft**: генерація повного контенту картки за одним введеним словом. GPT-5.2 підбирає «семантичну родину» для слова, визначення, приклади вживання та додає переклад на обрану користувачем мову.\n- 📝 **Examples**: створення додаткових прикладів із наявного тексту у полі 2.\n- 👩🏼 **TTS**: озвучення норвезького тексту високоякісним AI-голосом.\n- ☀️ **ChatGPT Assistant**: чат з GPT-5.2 для детальних консультацій, зі швидкими промтами та можливістю копіювати результат у буфер обміну (наприклад, для перекладів).\n\nДодаток використовує спеціально налаштовані промти для контролю якості відповідей AI. Користувач може гнучко змінювати ці промти під власні потреби.\n\n## Системні вимоги\n\n⚠️ **Важливо**: Цей додаток працює **тільки на Windows Desktop версії Anki**\n\n **Причина обмежень**: Додаток інтегрується безпосередньо в редактор карток Anki Desktop через системні hooks, використовує Windows-специфічні шляхи файлової системи та вбудоване у програму Anki Desktop Python-середовище. Це означає, що запустити додаток можна лише під Windows, але користуватися його результатами — згенерованими картками з аудіо — можна і на інших платформах.\n\n### Що необхідно:\n- ✅ **Windows 10 або новіша**\n- ✅ **Актуальна версія Anki Desktop для Windows**\n- ✅ **Вбудовані Python та Qt** (постачаються з Anki)\n\n### НЕ підтримується:\n- ❌ AnkiWeb (браузерна версія)\n- ❌ AnkiMobile (iOS додаток)\n- ❌ AnkiDroid (Android додаток)  \n- ❌ macOS/Linux (поки що)\n\n## Встановлення додатку\n\n### Приготуйте необхідні API ключі\n\n**OpenAI API ключ**\n- Перейдіть на: https://platform.openai.com/\n- Зареєструйтесь/увійдіть в акаунт\n- Створіть API ключ в розділі API Keys та відразу збережіть його в захищене місце!\n\n**ElevenLabs API ключ**\n- Перейдіть на: https://try.elevenlabs.io/l8ypk48ku2uk\n- Зареєструйтесь/увійдіть в акаунт\n- Створіть API ключ в Налаштуваннях акаунта та відразу збережіть його в захищене місце!\n- Виберіть бажаний голос озвучки та збережіть його id\n\n### Налаштування додатку\n\n1. Перевірте чи у вас встановлена остання версія Anki під Win: https://apps.ankiweb.net/\n2. Скопіюйте всю папку `InferAnki` до: `%APPDATA%\\Anki2\\addons21\\`\n3. Відкрийте `config.json` в будь-якому редакторі з підсвіткою.\n4. Додайте в `config.json` ваші API ключі:\n   - Додайте API ключ від OpenAI в поле `openai_api_key`\n   - Додайте API ключ від ElevenLabs в поле `elevenlabs_api_key`\n   - Додайте id голосу в поле `elevenlabs_voice_id`\n5. Запустіть Anki\n6. Налаштуйте поля 1 і 2 як показано на малюнках Card setup 1-3\n\n## Використання\n\n1. Відкрийте редактор карток Anki (Додати/Редагувати картку)\n2. Введіть норвезьке слово у поле 2\n3. Використовуйте кнопки панелі інструментів:\n   - ✨ **CardCraft** – щоб додати повний контент у поле 2 та переклад у поле 1\n   - 📝 **Examples** – щоб просто додати декілька релевантних прикладів вживання виразу у поле 2 (в полі 2 має бути хоча б одне норвезьке слово)\n   - 👩🏼 **TTS-Emma** – додає озвучку поля 2\n   - ☀️ **ChatGPT Assistant** – відкриває вікно чату з AI-асистентом\n\n## Інші налаштування\n\nВідредагуйте `config.json` для налаштування:\n- Параметри TTS голосу\n- Налаштування AI моделі\n- Мова перекладу\n- Debug-режим\n\n### Налаштування мови перекладу - поле 1\n\nЗа замовчуванням AI генерує переклади в поле 1 англійською мовою. Доступні мови: будь-які, хоч Клінгонська 👽. Щоб змінити мову перекладу поля 1 на іншу (наприклад, українську) відкрийте `config.json` та замініть:\n\n```json\n{\n    \"field_1_response_lang\": \"Ukrainian\"\n}\n```\n\n**Примітка:** Додаток автоматично використовує індекси полів у коді – тому назви полів у Анкі ні на що в коді додатку не впливають!\n\n**Налаштування контексту**\n\nЩоб персоналізувати AI-згенеровані приклади для вашої галузі/інтересів:\n\n1. Відкрийте: `prompts.json`\n2. Знайдіть: `\"user_context\": []`\n3. Замініть на ваш контекст, наприклад:\n   - Медицина: `[\"medisin\", \"helse\", \"sykehus\"]`\n   - Бізнес: `[\"økonomi\", \"business\", \"ledelse\"]`\n   - IT: `[\"programmering\", \"teknologi\", \"data\"]`\n   - Освіта: `[\"utdanning\", \"skole\", \"læring\"]`\n   - Право: `[\"jus\", \"lov\", \"rettsvesen\"]`\n\nЦе робить AI приклади більш релевантними до вашої галузі при вивченні норвезької лексики.\n\n### Налаштування чатбота\n\n**Детальна документація:** Дивіться `ChatBot-uk.md` для налаштування швидких промтів, кнопок перекладу та функції копіювання в буфер обміну.\n\n**Пам'ять розмови**: Чатбот запам'ятовує останні 10 пар повідомлень в межах кожної сесії діалогу для зв'язних багатоходових розмов. Кожне нове вікно починається заново.\n\n## Підтримка\n\n- Логи CardCraft: перевіряйте `InferAnki/logs/convert-*.log` у папці аддона\n- Увімкніть `debug_mode` в `config.json` для більш видимих повідомлень про помилки\n\n\n\n### ВАЖЛИВО! ПЕРЕЗАПУСКАЙТЕ ANKI ПІСЛЯ БУДЬ-ЯКОЇ ЗМІНИ НАЛАШТУВАНЬ!!!\n\n\n### ChatGPT Assistant\n![ChatGPT Assistant](images/Chatbot.jpg)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finferixon%2Finferanki","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finferixon%2Finferanki","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finferixon%2Finferanki/lists"}