From f61481f0e5889573ec83b02d3f04973fe849852e Mon Sep 17 00:00:00 2001 From: francesco Date: Tue, 27 Oct 2026 11:04:08 +0100 Subject: [PATCH 1/2] docs(distributing): engagement round of 27 Oct, stale rows fixed Co-Authored-By: Claude Opus 5.5 --- DISTRIBUTING.md | 39 ++++++++++++++++++++++++++++++++++----- 1 file changed, 34 insertions(+), 5 deletions(-) diff --git a/DISTRIBUTING.md b/DISTRIBUTING.md index 0e57079..fb95772 100644 --- a/DISTRIBUTING.md +++ b/DISTRIBUTING.md @@ -296,7 +296,7 @@ Il percorso seguente "ripercorre i passi" dei progetti studiati nell'ordine in c ## 8. Registro dei canali e delle ricerche già fatte -> **Aggiornato al 14 ottobre 2026; il punto al 19 ottobre è in §10.** Questa sezione evita di ripetere le stesse indagini: elenca dove gknowledge è già stato proposto, con quale esito, quali piattaforme coprono i competitor e quali ricerche non hanno prodotto nulla. Prima di cercare nuovi canali, aggiornare questa sezione. I testi pronti da incollare sono in [`docs/launch/`](docs/launch/) (`directories.md`, `outreach.md`, `blog-post.md`, `zh.md`, `emerging.md`). +> **Aggiornato al 14 ottobre 2026; il punto al 19 ottobre è in §10, il giro sull'engagement del 27 ottobre in §10.5.** Questa sezione evita di ripetere le stesse indagini: elenca dove gknowledge è già stato proposto, con quale esito, quali piattaforme coprono i competitor e quali ricerche non hanno prodotto nulla. Prima di cercare nuovi canali, aggiornare questa sezione. I testi pronti da incollare sono in [`docs/launch/`](docs/launch/) (`directories.md`, `outreach.md`, `blog-post.md`, `zh.md`, `emerging.md`). ### 8.1 Stato delle candidature @@ -304,13 +304,13 @@ Il percorso seguente "ripercorre i passi" dei progetti studiati nell'ordine in c |---|---|---|---|---| | [awesome-llm-wiki #12](https://github.com/gavischneider/awesome-llm-wiki/pull/12) | lista awesome (219★, la lista di categoria: nashsu, Tolaria, OpenKnowledge) | 14 ott 2026 | **merged** il 14 ott; ringraziato l'autore il 15 ott con link all'org | nessuno | | [awesome-opensource-ai #840](https://github.com/alvinreal/awesome-opensource-ai/pull/840) | lista awesome (4.884★, accanto a Khoj e Newelle) | 14 ott 2026 | **merged** il 15 ott; ringraziato l'autore con link all'org | nessuno | -| [awesome-gtk #465](https://github.com/valpackett/awesome-gtk/pull/465) | lista awesome (1.268★, Note-taking accanto a Iotas/Folio) | 14 ott 2026 | PR aperta, `lint.py` verde | attendere merge | -| [Karpathy-LLM-Wiki-Stack](https://github.com/ScrapingArt/Karpathy-LLM-Wiki-Stack/pull/2#issuecomment-6165166168) | blueprint (94★, tabella risorse con nashsu) | 14 ott 2026 | richiesta di revisione in un commento sulla PR #2; il repo non ha mai accettato PR esterne | se non risponde, aprire una issue | +| [awesome-gtk #465](https://github.com/valpackett/awesome-gtk/pull/465) | lista awesome (1.268★, Note-taking accanto a Iotas/Folio) | 14 ott 2026 | chiusa il 19 ott su richiesta del maintainer (vedi la riga awesome-gtk più sotto) | — | +| [Karpathy-LLM-Wiki-Stack](https://github.com/ScrapingArt/Karpathy-LLM-Wiki-Stack/pull/2#issuecomment-6165166168) | blueprint (94★, tabella risorse con nashsu) | 14 ott 2026 | richiesta di revisione in un commento sulla PR #2; la #2 è stata mergiata il 14 ott ma gknowledge non è nel README (verificato il 27 ott) | aprire una issue che proponga la riga, descritta per meccanismo | | AlternativeTo | directory | 14 ott 2026 | scheda inviata (coda gratuita, autore "Openapi"), 16 alternative collegate: Reor, Khoj, OpenKnowledge, Tolaria, Gemini Notebook (= NotebookLM), Mempipe, Obsidian, Logseq, SiYuan, Trilium, Zettlr, AnythingLLM, PrivateGPT, Open Notebook, Blinko, Nodus | attendere revisione; non condividere il link prima. La priorità costa $5 | | OpenAlternative | directory | 14 ott 2026 | **non inviata**: servono 250★ per repo con meno di 6 mesi (50★ dal 7 gen 2027) e un sito su dominio proprio; le schede gratuite escono una al giorno lavorativo | riprovare con `gknowledge.io` attivo | | EveryDev.ai | directory di AI dev tools (c'è OpenKnowledge) | 14 ott 2026 | login GitHub fatto; serve completare l'onboarding del profilo prima di `/create/tool` | completare onboarding, poi compilare con `directories.md` | | ClaudeKit (claudekit.io) | sito coreano curato a mano di strumenti per Claude Code (c'è nashsu) | 14 ott 2026 | **non raggiungibile**: nessun form, repo o contatto | nessuno | -| dev.to | articolo | 13 ott 2026 | [pubblicato](https://dev.to/francescobianco/i-turned-karpathys-llm-wiki-into-a-native-gnome-app-and-it-works-offline-130c). 17 ott: [commento di Justin (@fromthearchitect)](https://dev.to/fromthearchitect/comment/3i4d5), data/AI architect su Fedora che sta scrivendo un'app foto GNOME in Rust. Ha messo la stella; il `.deb` e `install.sh` non gli servono e chiede il Flatpak (non ha visto il remote su Pages: badge e tabella del README dicevano ancora "Flatpak planned"). Consiglia di sviluppare nel runtime GNOME e osserva che le pagine invecchiano per drift delle sorgenti, non per allucinazioni. Da qui nascono il controllo "stale sources" e `make start-flatpak` (PR #42, mergiato il 19 ott; il PR #43 corregge il click nella sidebar) | **risposto il 19 ott** dall'utente, dopo il rilascio della 0.3.0 con il Flatpak; ringraziato anche nell'[annuncio della 0.3](https://github.com/orgs/openapi/discussions/72). **Lui ha risposto la sera del 19 ott** ([commento](https://dev.to/fromthearchitect/comment/3ia9i)): apprezza `stale_sources` via MCP e il fix WAL/document portal, autorizza il link alla [Parte 1](https://fromthearchitect.dev/posts/gnome-rust-part-1-getting-started/) della sua serie (aggiunto in CONTRIBUTING il 20 ott), proverà il Flatpak su Fedora 44 in settimana e aprirà issue (GitHub `justinf555`): smistarle per prime. **27 ott** ([commento](https://dev.to/fromthearchitect/comment/3iek7)): il Flatpak su Fedora 44 funziona, nessun problema; ringrazia per il link e segnala che la serie continua (è alla Parte 6 più un bonus). CONTRIBUTING ora linka la [pagina della serie](https://fromthearchitect.dev/series/building-gnome-apps-with-rust/). Risposta preparata per l'utente: grazie, link aggiornato, proposta di usare la sua serie come base di conoscenza demo di gknowledge (con link a ogni post, risultato mostrato a lui prima di pubblicare). Commentare con contenuto tecnico i suoi articoli recenti sulle liste GTK4 (0–1 reazioni), senza chiedere stelle. Più avanti: cross-promozione tra app GNOME e, se il rapporto cresce, co-maintainer per il packaging (§6). Ripubblicare su Medium con canonical a dev.to | +| dev.to | articolo | 13 ott 2026 | [pubblicato](https://dev.to/francescobianco/i-turned-karpathys-llm-wiki-into-a-native-gnome-app-and-it-works-offline-130c). 17 ott: [commento di Justin (@fromthearchitect)](https://dev.to/fromthearchitect/comment/3i4d5), data/AI architect su Fedora che sta scrivendo un'app foto GNOME in Rust. Ha messo la stella; il `.deb` e `install.sh` non gli servono e chiede il Flatpak (non ha visto il remote su Pages: badge e tabella del README dicevano ancora "Flatpak planned"). Consiglia di sviluppare nel runtime GNOME e osserva che le pagine invecchiano per drift delle sorgenti, non per allucinazioni. Da qui nascono il controllo "stale sources" e `make start-flatpak` (PR #42, mergiato il 19 ott; il PR #43 corregge il click nella sidebar) | **risposto il 19 ott** dall'utente, dopo il rilascio della 0.3.0 con il Flatpak; ringraziato anche nell'[annuncio della 0.3](https://github.com/orgs/openapi/discussions/72). **Lui ha risposto la sera del 19 ott** ([commento](https://dev.to/fromthearchitect/comment/3ia9i)): apprezza `stale_sources` via MCP e il fix WAL/document portal, autorizza il link alla [Parte 1](https://fromthearchitect.dev/posts/gnome-rust-part-1-getting-started/) della sua serie (aggiunto in CONTRIBUTING il 20 ott), proverà il Flatpak su Fedora 44 in settimana e aprirà issue (GitHub `justinf555`): smistarle per prime. **27 ott** ([commento](https://dev.to/fromthearchitect/comment/3iek7)): il Flatpak su Fedora 44 funziona, nessun problema; ringrazia per il link e segnala che la serie continua (è alla Parte 6 più un bonus). CONTRIBUTING ora linka la [pagina della serie](https://fromthearchitect.dev/series/building-gnome-apps-with-rust/). **Risposto dall'utente il 27 ott**: grazie, link aggiornato, proposta di usare la sua serie come base di conoscenza demo di gknowledge (con link a ogni post, risultato mostrato a lui prima di pubblicare); attendere la sua risposta. Commentare con contenuto tecnico i suoi articoli recenti sulle liste GTK4 (0–1 reazioni), senza chiedere stelle. Più avanti: cross-promozione tra app GNOME e, se il rapporto cresce, co-maintainer per il packaging (§6). Ripubblicare su Medium con canonical a dev.to | | Theo James (Medium, editor di *Better Workflow*) | classifica "8 Apps… Karpathy-Style LLM Knowledge Base" | 14 ott 2026 | testo pronto in `outreach.md` (risposta all'articolo o pitch alla pubblicazione); nessun contatto esterno | inviare da account Medium | | Prahlad G. Menon (themenonlab.blog) | blog che ha coperto Tolaria e OKF | 14 ott 2026 | email pronta in `outreach.md` (prahlad.menon@quant.md) | inviare | | awesome-gnome (1.622★, c'è Newelle) | lista awesome | — | **saltata**: richiede release stabili mature | proporre dopo Flathub | @@ -535,7 +535,7 @@ Obiettivo originale: 30+ stelle nelle 24 ore dello Show HN, per entrare nel tren - **Glama.** `openapi/mcp-server` risulta rivendicato dall'account dell'utente e ha voto B: il badge già presente nella riga della #16968 si risolve, punkpeye ringraziato. `openapi/gknowledge` inviato con nome e descrizione da app ed è stato **rifiutato**: per il revisore descriveva un'app GNOME e non un server MCP, e cita la descrizione del repo ("native GNOME knowledge workstation"). Reinviato come `gknowledge-mcp`, con descrizione che parte da "Stdio MCP server" ed elenca i tool: rifiutato perché "MCP server already exists for this repository". Infatti la scheda `openapi/gknowledge` esiste e ha voto A, nonostante l'email di rifiuto del primo invio. Badge aggiunto nella riga della #16969, punkpeye ringraziato. Le email di Glama non vanno prese alla lettera: verificare il badge (`` dell'SVG). - **Lezione per le directory MCP**: presentare gknowledge come `gknowledge-mcp` con i tool in prima riga, non come app; la descrizione del repo su GitHub pesa nella revisione. - **awesome-context-engineering #88**: mergiata il 24 ott; ringraziato yzfly con invito a seguire l'org. -- **Justin**: Flatpak verificato su Fedora 44 (primo test esterno fuori da Ubuntu); CONTRIBUTING linka tutta la sua serie. Risposta su dev.to all'utente. +- **Justin**: Flatpak verificato su Fedora 44 (primo test esterno fuori da Ubuntu); CONTRIBUTING linka tutta la sua serie. L'utente gli ha risposto il 27 ott proponendo la base di conoscenza demo. ### 10.4 Il post su Hacker News del 19 ottobre @@ -545,3 +545,32 @@ Il 19 ottobre alle 14:36 UTC l'utente ha pubblicato su HN [*The Second Brain Gno - **Rischi segnalati e accettati**: titolo che invita al flag, link a una pagina di annuncio invece che al repo, assenza da /show, effetto su un eventuale Show HN successivo. Proposta di cancellarlo finché aveva 0 commenti: **rifiutata**. L'utente accetta di perdere il lancio HN pianificato e sta preparando un repository separato per far crescere il karma dell'account. - **Conseguenza per il piano**: lo Show HN del 27/28 ottobre esce dalla sequenza di §10.3. HN resta un canale dell'utente, gestito alle sue condizioni; non va più riproposto nei piani. - **Da osservare**: punti, commenti e stato `dead` o `flagged` dell'item 50153030; referrer `news.ycombinator.com` nel traffico del repo e della discussione #72. +- **Esito al 27 ottobre**: 2 punti, 0 commenti, item `dead`. Nel traffico del repo, 2 visitatori unici da news.ycombinator.com in 14 giorni. + +### 10.5 Giro sull'engagement (27 ottobre 2026) + +**I numeri.** Fonti: `gh api repos/openapi/gknowledge`, `/traffic/views`, `/traffic/popular/referrers`, stargazers con `starred_at`. + +- **Stelle: 24** (19 il 19 ott). Le 5 nuove: passasooz, evanjrowley e robertogallea il 19, simonetravaglini e AdityaWagh06 il 20, justinf555 il 21. Watcher: 0. Fork: 6. +- **Visite uniche al giorno**: 15 il 19 ott (0.3.0, post HN, LinkedIn), 10 il 20, 5 il 21, poi 0–4 dal 22. Dal 21 ott non è partita nessuna azione verso l'esterno, e il traffico segue le azioni, come già visto in §10.1. +- **Referrer in 14 giorni (unici)**: LinkedIn **14** (10 dal web e 4 dall'app Android), github.com 10, alternativeto.net 4, Google 3, news.ycombinator.com 2, DuckDuckGo 1, up-for-grabs.net 1. **LinkedIn è il primo canale esterno** ed è l'unico tra quelli dell'utente che ha portato persone; HN, che pesava di più nel piano, ne ha portate 2. +- **Rimasti indietro dal §10.3**: nessun item TWIG (0 menzioni nel feed di thisweek.gnome.org), nessuna segnalazione a Phoronix e OMG! Ubuntu, nessun articolo di aggiornamento su dev.to (l'ultimo è quello del 13 ott: 6 reazioni, 2 commenti), nessun post Reddit. +- **Candidature ferme**: awesome-for-beginners #2143 e ollama #19001 (dal 14 ott), awesome-hacktoberfest-2026 #22 (dal 15), HelloGitHub #3956, ruanyf #12333 e OpenGithubs #33 (dal 13): nessun commento. awesome-mcp-servers #16968 e #16969: ora `has-glama`, in attesa di merge. + +**Azioni, in ordine di resa attesa.** + +| # | Azione | Chi | Perché | +|---|---|---|---| +| 1 | **PR #46 di AdityaWagh06** (rilevamento di Ollama locale nelle preferenze, +468/−9): aperta il 20 ott e mai commentata da un umano; la CI è ferma su `action_required` perché va approvata per i fork. Approvare la CI, rivedere e rispondere entro oggi, ringraziando | utente (approvazione), noi (revisione) | è il suo terzo contributo (#1, #19). Un contributore che torna vale più di qualsiasi lista, e sette giorni di silenzio sono il modo più rapido per perderlo | +| 2 | **LinkedIn di nuovo**: post per la 0.3 (Flatpak su qualsiasi distro, testato su Fedora 44 da un utente esterno, server MCP con voto A su Glama) dal profilo personale e da quello aziendale; i colleghi lo condividono con parole proprie | utente | primo referrer esterno: 14 visitatori unici in 14 giorni, più di HN, Google e AlternativeTo messi insieme | +| 3 | **Item TWIG** entro giovedì 29 ott per l'uscita di venerdì 30, testo in `docs/launch/README.md`; nello stesso giorno, segnalazione a Phoronix e OMG! Ubuntu | utente | era il gancio della 0.3 (§10.2) e non è ancora stato usato; il Flatpak è ora verificato anche su Fedora | +| 4 | **Demo con la serie di Justin**, se accetta: compilare *Building GNOME Apps with Rust* in un wiki gknowledge, poi l'articolo di aggiornamento su dev.to ("I compiled a GNOME dev series into a wiki my agents can cite"), mostrato prima a lui | noi (demo), utente (articolo) | trasforma un rapporto già caldo in contenuto con due pubblici; lui ha una ragione per condividerlo | +| 5 | **r/selfhosted** venerdì 30 ott (New Project Friday), affiliazione dichiarata; r/LocalLLaMA e r/ObsidianMD nei giorni dopo, con testi diversi | utente | in sospeso dal §10.3; serve karma Reddit | +| 6 | **Commenti tecnici sugli articoli GTK4 di Justin** (0–1 reazioni ciascuno), senza link al progetto | utente | reciprocità: il suo pubblico è quello di gknowledge | +| 7 | **Hacktoberfest finisce il 31 ott**: dopo, la #22 di awesome-hacktoberfest-2026 perde valore. Nessun sollecito; le issue di traduzione (#34–#40) restano `good first issue` per awesome-for-beginners e up-for-grabs | — | non vale un sollecito a un maintainer inattivo da novembre 2025 | +| 8 | **Un solo sollecito gentile** su awesome-for-beginners #2143 dopo tre settimane (4 nov), se resta ferma | noi | lista da 90k★ con pubblico in India e Africa, coerente con le traduzioni aperte | +| 9 | **Issue su Karpathy-LLM-Wiki-Stack** che proponga la riga di gknowledge, descritta per meccanismo | noi | la #2 è stata mergiata senza di noi | + +**Da non fare.** Chiedere stelle o follow a chi non ha ancora usato l'app; solleciti alle newsletter cinesi (HelloGitHub smaltisce la coda lentamente, un sollecito non la accelera); cambiare il README per un canale (vedi la memoria del progetto); riproporre HN (§10.4). + +**Metrica di controllo per il 3 novembre**: visite uniche giornaliere sopra 5 per almeno tre giorni, 30 stelle, risposta sulla #46, merge di #16968 e #16969. From e2464d9becb10157ed38ce5fa4245a5b21a498db Mon Sep 17 00:00:00 2001 From: francesco <info.francescobianco@gmail.com> Date: Tue, 27 Oct 2026 11:08:19 +0100 Subject: [PATCH 2/2] docs(launch): ready texts for the 0.3 push (LinkedIn EN/IT, TWIG, Phoronix, r/selfhosted) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/launch/README.md | 67 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) diff --git a/docs/launch/README.md b/docs/launch/README.md index ca3fe2e..f2306c0 100644 --- a/docs/launch/README.md +++ b/docs/launch/README.md @@ -70,6 +70,73 @@ Each post: one screenshot or the demo, two short paragraphs, the install line, a - **This Week in GNOME** (Matrix room `#thisweek:gnome.org`): "gknowledge 0.3 is out: a native GTK 4 and Libadwaita app that turns your documents into a linked, cited wiki, offline by default, with optional local or ChatGPT models. New in 0.3: a Flatpak for any distribution (`flatpak install --user https://openapi.github.io/gknowledge/io.github.openapi.Gknowledge.flatpakref`), PDF import inside the sandbox, and sources that changed since ingest are flagged so the pages built from them can be updated." - **Phoronix tip and OMG! Ubuntu tip:** link to the release page, the one-liner, and two screenshots. +## Week of 27 October: texts for the 0.3 push + +New facts since the 0.3.0 release, usable everywhere below: the Flatpak was tested on Fedora 44 by an outside user with no issues, and the MCP server is listed on Glama with an A quality score. + +### LinkedIn (personal profile, then the Openapi page) + +LinkedIn has been the top external referrer (14 unique visitors in 14 days), so this goes first. Colleagues should reshare with a line of their own, not "please star". + +**English:** + +> gknowledge 0.3 is out, and it now installs on any Linux distribution. +> +> It's our open-source take on Andrej Karpathy's "LLM Wiki" idea: instead of re-reading your documents for every question, a model compiles them once into a linked Markdown wiki, keeps track of where each page comes from, and answers with citations. +> +> What's new: +> • A Flatpak that works on any distro (an outside user just confirmed it on Fedora 44) +> • Pages flag themselves when the source document changes, so the wiki doesn't quietly go stale +> • An MCP server, rated A on Glama, so Claude Code or Codex can search and grow the same wiki +> +> It works offline by default; you can plug in Ollama or your own ChatGPT plan. MIT licensed, built with GTK 4 and Libadwaita. +> +> https://github.com/openapi/gknowledge + +**Italiano:** + +> È uscita gknowledge 0.3, e ora si installa su qualsiasi distribuzione Linux. +> +> È la nostra versione open source dell'idea "LLM Wiki" di Andrej Karpathy: invece di rileggere i documenti a ogni domanda, un modello li compila una volta in un wiki Markdown collegato, tiene traccia della fonte di ogni pagina e risponde con le citazioni. +> +> Le novità: +> • un Flatpak che funziona su ogni distro (un utente esterno l'ha appena verificato su Fedora 44) +> • le pagine si segnalano da sole quando il documento di origine cambia, così il wiki non invecchia in silenzio +> • un server MCP, con voto A su Glama, per far cercare e ampliare lo stesso wiki a Claude Code o Codex +> +> Funziona offline di default; si può collegare Ollama o il proprio piano ChatGPT. Licenza MIT, costruita con GTK 4 e Libadwaita. +> +> https://github.com/openapi/gknowledge + +### This Week in GNOME (by Thursday for Friday's issue) + +Use the text in "GNOME channels" above and add one sentence: "The Flatpak has been tested on Fedora 44 as well as Ubuntu." Attach one screenshot of the main window. + +### Phoronix and OMG! Ubuntu tip + +> **Subject:** gknowledge 0.3: Karpathy's LLM Wiki as a native GTK 4 app, now as a Flatpak +> +> Hi, a tip in case it fits: gknowledge is an MIT-licensed GTK 4 + Libadwaita app that turns documents into a linked, cited Markdown wiki, offline by default, with optional Ollama or ChatGPT models. Version 0.3 adds a Flatpak for any distribution (tested on Ubuntu and Fedora 44), PDF import inside the sandbox, and pages that flag themselves when their source file changes. It also ships an MCP server so coding agents can use the same wiki. +> +> Release: https://github.com/openapi/gknowledge/releases/tag/v0.3.0 +> Install: `flatpak install --user https://openapi.github.io/gknowledge/io.github.openapi.Gknowledge.flatpakref` +> +> Disclosure: I maintain it. + +### r/selfhosted (New Project Friday, 30 October) + +**Title:** gknowledge: a self-hosted, offline "LLM wiki" that compiles your documents into a cited Markdown vault + +> I maintain this, so take it with that in mind. +> +> gknowledge follows Karpathy's LLM Wiki pattern: documents go into an immutable `sources/` folder, and a model (or the built-in offline engine, no model needed) compiles them into linked Markdown pages with provenance. Questions come back with citations. Everything stays on your disk as a plain folder you can open in Obsidian or back up with git. +> +> For self-hosters specifically: no cloud account, no telemetry, works with Ollama on the same box, and there's a stdio MCP server (`uvx gknowledge-mcp --init <folder>`) if you want agents on a headless machine to use the wiki without the desktop app. +> +> Desktop app is GTK 4 (Flatpak for any distro). Repo: https://github.com/openapi/gknowledge +> +> What would you need from it to replace your current notes or docs setup? + ## Chinese communities Short post for V2EX (分享创造) and 掘金: "把 Karpathy 的 LLM Wiki 做成了原生 GNOME 应用：导入文档，自动生成带出处的链接知识库，带引用问答，默认离线，可用自己的 ChatGPT 套餐或 Ollama。" plus the install line and the 简体中文 README link.