{"id":49008328,"url":"https://github.com/hunkontech/koai","last_synced_at":"2026-05-14T22:01:36.077Z","repository":{"id":352186291,"uuid":"1202176645","full_name":"HunKonTech/KOAI","owner":"HunKonTech","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-25T10:58:59.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-27T23:28:53.388Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HunKonTech.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-05T17:43:00.000Z","updated_at":"2026-04-18T09:32:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/HunKonTech/KOAI","commit_stats":null,"previous_names":["hukontech/koai","hunkontech/koai"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/HunKonTech/KOAI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HunKonTech%2FKOAI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HunKonTech%2FKOAI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HunKonTech%2FKOAI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HunKonTech%2FKOAI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HunKonTech","download_url":"https://codeload.github.com/HunKonTech/KOAI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HunKonTech%2FKOAI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33045145,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-14T02:00:06.663Z","response_time":57,"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":[],"created_at":"2026-04-18T21:18:23.048Z","updated_at":"2026-05-14T22:01:36.072Z","avatar_url":"https://github.com/HunKonTech.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"License Notice\n\nThis project is source-available for personal, non-commercial use only.\nCommercial use is not allowed without prior written permission.\nModification, redistribution, and public forking are prohibited.\nSee LICENSE.txt for full terms.\n\n# KOAI\n\nKOAI is a local-first macOS research assistant for turning a topic into a structured, traceable research workflow.\n\nIt searches the web in the background, extracts readable content from promising pages, stores everything locally in SQLite, and produces a concise synthesized report with a local or local-friendly LLM backend.\n\n## Highlights\n\n- Topic-driven research jobs\n- Ad hoc prompts for one-off investigations\n- Background browsing with `WKWebView`\n- Source discovery, ranking, deduplication, and extraction\n- Incremental article summaries plus final synthesis\n- SQLite persistence for jobs, sources, articles, traces, and summaries\n- Local model support for `llama.cpp`, `llama-server`, and `ollama`\n- Hugging Face model library browsing for local-friendly models\n- English and Hungarian UI localization\n\n## What KOAI is for\n\nKOAI is a good fit when you want to:\n\n- research a topic without manually opening dozens of tabs\n- keep the process organized and repeatable\n- inspect what the app searched, opened, and extracted\n- summarize multiple sources into one readable output\n- keep data on your machine instead of sending it to a cloud service\n\nKOAI is not a general-purpose browser, not a feed reader, and not a single-site scraper. It is designed around staged, topic-based research.\n\n## How it works\n\n1. Create or select one or more topics.\n2. Start a research job from those topics or enter an ad hoc prompt.\n3. KOAI builds a query plan and searches for relevant sources.\n4. The app opens promising pages in a hidden browser, extracts text, and stores the results.\n5. It summarizes individual articles and then combines them into a final report.\n6. You can review the job history, traces, sources, and summary from the UI.\n\n## Screens\n\nAdd screenshots here once you have them:\n\n- Main dashboard\n- Topic editor\n- Research job progress\n- Source and summary view\n\n## Requirements\n\n- macOS 14 or later\n- Swift 6\n- A local `llama.cpp` or `ollama` setup if you want LLM-powered summaries\n\nIf no model runtime is available, KOAI can fall back to extractive summarization.\n\n## Local model support\n\nKOAI can use several backends depending on your setup:\n\n- `llama.cpp` CLI or server\n- `ollama`\n- extractive fallback when no model is available\n\nThe built-in model library view helps you discover GGUF-friendly models that are better suited for local Apple Silicon use.\n\n---\n\n# KOAI\n\nKOAI egy helyi működésre épülő, macOS-re készült kutatóasszisztens. Egy témából strukturált, visszakövethető research folyamatot csinál: háttérben böngészik, kinyeri az olvasható tartalmat, SQLite-ba ment mindent, majd helyi vagy helyben futó LLM-mel összefoglalót készít.\n\n## Kiemelt funkciók\n\n- témavezérelt kutatási jobok\n- ad hoc promptok egyszeri vizsgálatokhoz\n- háttérben futó böngészés `WKWebView`-val\n- források felderítése, rangsorolása, deduplikálása és kinyerése\n- cikkenkénti összegzés és végső szintézis\n- SQLite tárolás jobokhoz, forrásokhoz, cikkekhez, trace-ekhez és összefoglalókhoz\n- helyi támogatás `llama.cpp`, `llama-server` és `ollama` számára\n- Hugging Face modellnézet lokálisan barátságos modellekhez\n- angol és magyar felület\n\n## Mire jó\n\nA KOAI jó választás, ha szeretnél:\n\n- egy témát sok kézi böngészés nélkül feldolgozni\n- az egész kutatási folyamatot rendezett, ismételhető módon kezelni\n- visszanézni, mit keresett az app és milyen oldalakat dolgozott fel\n- több forrásból egy egységes, rövid összefoglalót kapni\n- az adatokat a saját gépeden tartani, nem felhőben\n\nNem általános böngésző, nem feed reader, és nem egyetlen webhelyre optimalizált scraper. Lépésenkénti, témavezérelt kutatásra készült.\n\n## Működés\n\n1. Létrehozol vagy kiválasztasz egy vagy több témát.\n2. Elindítasz egy kutatási jobot ezekből a témákból, vagy megadsz egy ad hoc promptot.\n3. A KOAI keresési tervet készít és releváns forrásokat keres.\n4. Az app egy rejtett böngészőben megnyitja az ígéretes oldalakat, kinyeri a szöveget, és elmenti az eredményt.\n5. Az egyes cikkeket összefoglalja, majd ezekből elkészíti a végső riportot.\n6. A felületen visszanézheted a job előzményeit, trace-it, forrásait és az összefoglalót.\n\n## Képernyők\n\nIde érdemes később képernyőképeket tenni:\n\n- fő nézet\n- téma szerkesztő\n- research job állapot\n- forrás- és összefoglaló nézet\n\n## Követelmények\n\n- macOS 14 vagy újabb\n- Swift 6\n- Lokális `llama.cpp` vagy `ollama` telepítés, ha LLM-alapú összegzést szeretnél\n\nHa nincs model runtime, a KOAI extractive fallback módban is tud működni.\n\n## Lokális futtatás\n\n## Helyi modellek támogatása\n\nA KOAI több backendet is tud használni a környezetedtől függően:\n\n- `llama.cpp` CLI vagy szerver\n- `ollama`\n- extractive fallback, ha nincs elérhető modell\n\nA beépített modellnézet segít GGUF-barát modellek keresésében, különösen Apple Silicon környezetben.\n\n## Miért ilyen az architektúra\n\n- a `SwiftUI` natív macOS felületet ad\n- a `WKWebView` beágyazott, privacy-barát böngészéshez jó\n- az `SQLite` mindent helyben és tartósan tárol\n- a helyi backend absztrakció miatt az app cloud modell nélkül is használható\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhunkontech%2Fkoai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhunkontech%2Fkoai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhunkontech%2Fkoai/lists"}