Към съдържанието
PN Scripts

AI

AI асистент, който работи на вашия компютър и помни работата ви

PN Scripts Assistant учи проектите и документите ви, отговаря от тази памет и върши истинска работа с 78 вградени инструмента. Моделът работи в Ollama на вашата машина, паметта е един файл на диска ви, а в частен режим нищо от разговорите ви не напуска компютъра.

  • Go
  • SQLite
  • Ollama
  • GTK 3 and WebKitGTK
  • whisper.cpp

Вземете го от

Командният център на PN Scripts Assistant с въпрос за проект, отговорен от паметта

Какъв проблем решава

Празнината

Хостваните асистенти пращат всеки въпрос към чужди сървъри и започват всяка сесия, без да знаят нищо за работата ви. Локалният чат прозорец пази данните у дома, но не може да отвори файл, да запомни проект или да свърши нещо вместо вас.

Какво представлява

Една програма на Go и един SQLite файл. Използва модел, пуснат в Ollama, учи от папките, които му посочите, пази фактите, които може да провери, и ви пита за тези, които е извел. Когато въпросът изисква действие, използва инструментите си според нивото на разрешения, което сте задали.

Как се използва

Инсталирайте Ollama и изданието за вашата система. При първото пускане той пита къде да пази паметта и кой модел да използва, а инструментът doctor инсталира липсващото.

Ollama изпълнява езиковия модел. PN Scripts Assistant добавя дългосрочна памет, инструменти, разрешения, режими на поверителност, глас и интерфейс и пази наученото на вашия диск.

Как се отговаря на въпрос

Всичко по-долу работи на вашия компютър в частен режим, който е по подразбиране. Интерфейсът се сервира само на 127.0.0.1.

  1. Питате

    Пишете в прозореца, а в Windows в браузъра. В Linux можете и да кажете "Assistant" и да говорите.

  2. Той си припомня

    Търси в паметта по смисъл, с ембединги от nomic-embed-text в Ollama, и добавя важното към заявката.

  3. Локалният модел отговаря

    Ollama изпълнява модела за разговор на 127.0.0.1:11434. Настройката избира модел според хардуера, например qwen2.5-coder:7b на компютър без видеокарта.

  4. Действа, ако въпросът го изисква

    Извиква вграден инструмент или инструмент на MCP сървър според настройката ви за разрешения. Всяко извикване се записва.

  5. Учи

    Extractor предлага факти от разговора, validator ги проверява, а curator ги записва. Изведените факти чакат вашето одобрение.

Памет, която остава ваша

Локалният модел сам по себе си ви забравя след всеки разговор. PN Scripts Assistant пази наученото за вашите проекти, документи и разговори и го използва във всеки отговор.

  • Учи от папките ви

    Посочете му проектите и документите си и той ги прочита. Факт за файл се проверява срещу диска, преди да бъде запазен.

  • Пита за изведеното

    Фактите, които е извел от разговор, чакат в списък, докато ги приемете или откажете. Фактите, които може да провери, се пазят сами.

  • Карта на наученото

    Картата на паметта показва всеки спомен в 3D, подреден по истинската близост на ембедингите и оцветен според източника: проекти, документи, разговори и сайтове.

  • Един файл, който можете да преместите

    Всичко е в brain.sqlite, в папка, маркирана с .brain-root.json. Той намира тази папка на всеки монтиран диск, така че паметта може да е на външен диск. Инструментът за команден ред може да я премести и проверява всеки байт.

Все още няма екран за редакция на отделен факт. Инструментът за команден ред може да подреди паметта, да започне отначало или да я премести.

Карта на паметта с документи и проекти като 3D мрежа от свързани спомени
Картата на паметта: 24 документа и 9 проекта, подредени по истинската близост на ембедингите.

Не само разговор: той върши работата

v0.2.2 има 78 вградени инструмента, а всеки MCP сървър, който свържете, добавя свои. Вие решавате кои може да ползва, без да пита.

  • Файлове и документи

    Чете, търси, пише и редактира файлове и документи. Файл, който е променил, може да се върне.

  • Команди

    Пуска програми директно, без shell, с ограничение от пет минути. В Linux командите работят под ограничение с Landlock.

  • Уеб

    В режим research или open търси с DuckDuckGo или с Brave Search с ваш ключ и чете страници. Отказва адреси от частни мрежи.

  • Денят и домът ви

    Дневник и напомняния, имейл през SMTP и IMAP, след като го настроите, и лампи, ключове, климатици, щори, вентилатори и брави в Home Assistant. В Linux може и да отваря програми, да пише и да щрака.

  • Разрешения, които вие задавате

    Три нива: пита всеки път; прави позволеното и пита за останалото; или действа свободно, което е по подразбиране. Всяка възможност може да се настрои отделно и всяко извикване се записва. Последните 60 променени файла се пазят до 14 дни, за да могат да се върнат.

Във v0.2.2 нивото на разрешения следва режима на поверителност при зареждане на настройките: research го вдига поне до "пита за останалото", а open до "действа свободно". В частен режим изборът ви остава какъвто е.

Списък с разрешения, където всяка възможност се настройва да пита или не
Всяка възможност се настройва отделно. Тук всяка пита първо.

Три режима на поверителност, наложени в кода

Режимът решава какво може да напусне компютъра, а защита в кода спира всичко, което режимът не позволява, каквото и да поиска моделът. Частният режим е по подразбиране, а непозната стойност се чете като частна. Настройката "търси онлайн", включена по подразбиране, проверява за обновления и списъци с модели; тя е отделна от режима на поверителност и може да се изключи.

private По подразбиране

Остава на този компютър

Съобщенията ви, паметта, файловете ви и моделът. Моделът за разговор и ембедингите работят в Ollama на този компютър.

Напуска този компютър

Нищо от разговорите ви. Уеб инструментите са скрити.

research

Остава на този компютър

Разговорите ви, паметта и моделът.

Напуска този компютър

Заявки за търсене към DuckDuckGo или Brave Search и заявки за страниците, които чете.

open Ваш API ключ

Остава на този компютър

Самата база данни на паметта.

Напуска този компютър

Съобщенията ви и паметта, извлечена за този ход, изпратени към избрания от вас хостнат доставчик, например Anthropic, OpenAI, Google или Mistral.

Говорете му

Гласът работи на компютъра: whisper.cpp превръща речта в текст, а Piper, espeak-ng или speech-dispatcher чете отговора на глас. Във v0.2.2 слушането работи в Linux.

  • Дума за събуждане

    Кажете "Assistant" и попитайте. Микрофонът е изключен, докато не го включите.

  • Режим на разговор

    Слуша, докато спрете да говорите, отговаря, чете отговора на глас и слуша отново.

  • Изговорената заявка може да действа

    Изговорената заявка може да ползва същите инструменти като написаната, при същата настройка за разрешения. При "действа свободно" може да промени нещо, без да пита; задайте в Разрешения да пита, ако искате първо да потвърдите.

  • Разпознава гласа ви, ако искате

    Незадължителен гласов отпечатък му позволява да отговаря само на вас. Потискането на ехо през PipeWire е налично и е изключено по подразбиране.

Слушането, потискането на ехо и гласовият отпечатък са само за Linux във v0.2.2. В Windows пишете.

Настройки с името на асистента, името на собственика, думата за събуждане и гласа
Името му, вашето име, думата за събуждане и гласът, с който говори.

За разработчици

Познава хранилищата ви

Посочете му папката с проекти и питайте кой проект какво прави, къде е и с какво е направен. Отговорът идва от файловете ви.

Познава машината ви

Търси инсталираните езици, редактори, игрови енджини и AI инструменти за код, като Go, Godot, Claude Code или Codex, и може да пусне всяка програма чрез инструмента за команди.

Разширява се с MCP

Свържете MCP сървъри и инструментите им се появяват до вградените, при същите разрешения и в същия запис.

Команден ред и doctor

Всяко издание има клиент за команден ред и doctor, който проверява изискванията и с --install инсталира липсващото, след като попита.

Код, който можете да прочетете

Go 1.26 под лиценз MIT: 163 000 реда, от които 44 000 са тестове в 71 пакета. Разработва се открито в GitHub.

За кого е

Използвайте го когато

  • Питайте къде е даден проект, с какво е направен или кой документ споменава нещо и получете отговор от собствените си файлове.
  • Оставете го да чете, търси и редактира файлове или да пуска команди, като всяко действие се записва и може да се отмени.
  • Пазете клиентски или лични данни далеч от хостнати AI услуги, като работите в частен режим.
  • Говорете му на бюрото си в Linux и управлявайте устройства в Home Assistant с глас или текст.

Направено за

  • Разработчици, които вече ползват Ollama и искат асистент, който познава хранилищата им.
  • Хора, които искат асистент с памет на собствения си компютър, а не в акаунт.
  • Екипи и фрийлансъри, чиито данни не бива да отиват към хостнат модел.
  • Потребители на Home Assistant, които искат локално управление с глас и текст.

Скорост, измерена

Измерено на Ubuntu 24.04 с 4 процесорни ядра, 31 GB памет, без видеокарта и с qwen2.5-coder:7b в Ollama. На процесор дължината на заявката решава по-голямата част от чакането.

Четене на заявката

8 до 10 tok/s

README измерва около 10, нашият одит около 8

Писане на отговора

~2,5 tok/s

Генериране на процесора

Кратък отговор, зареден модел

6,8 s

15,8 s, когато Ollama трябва да зареди модела отново

Ход с инструменти

~58 s

След загряване. Първият ход след пускане отне около 10 минути: заявка от 6338 токена, от които около 5100 са описания на инструменти

Видеокарта или хостнат модел в режим open са много по-бързи. В режим open съобщенията ви и извлечената памет отиват към този доставчик. По-малък локален модел също е по-бърз: в нашите тестове llama3.2:3b работи двойно по-бързо, но избра правилния инструмент в 2 от 5 случая. Задайте OLLAMA_MAX_LOADED_MODELS=2, за да държи Ollama заредени и модела за разговор, и модела за ембединги.

Инсталиране

Нужни са Ollama и няколко гигабайта за моделите. Изданията са в GitHub, с контролни суми SHA256.

  1. Инсталирайте Ollama и моделите

    Инсталирайте Ollama от ollama.com и изтеглете модел за разговор и модела за ембединги. Първото пускане също може да ги инсталира.

    ollama pull qwen2.5-coder:7b
    ollama pull nomic-embed-text
  2. Инсталирайте изданието за вашата система

    В Ubuntu или Debian инсталирайте .deb пакета. В Windows пуснете програмата за инсталиране; не иска администраторска парола.

    sudo apt install ./pn-scripts-assistant_0.2.2_amd64.deb
  3. Отговорете на въпросите при първо пускане

    Изберете къде да се пази паметта, кой модел да се ползва и, ако искате, ключове за хостнати доставчици. После му дайте име и му кажете своето.

  4. Оставете doctor да провери останалото

    Doctor показва какво липсва, например гласови инструменти или библиотеката WebKitGTK, и инсталира каквото може, след като попита.

    pn-scripts-assistant-doctor --install

Какво получава всяка система във v0.2.2

Linux Пълна версия
x86-64. Собствен прозорец (GTK 3, WebKitGTK 4.1), глас, управление на работния плот и ограничение с Landlock. Пакет .deb или един изпълним файл.
Windows 10+ Интерфейс в браузъра
64-битов. Програма за инсталиране или zip; отваря се в браузъра. Още няма слушане, управление на работния плот и ограничение. Не е подписан, затова Windows може да предупреди преди пускане.

Спецификации

Разработчик
PN Scripts
Вид
Приложение
Платформи
Go
Последна версия
v0.2.2
Ценообразуване
Безплатно
Лиценз
MIT
Внедряване
На собствен компютър
Зрялост
Ранно издание, v0.2.2
Поддръжка
Общност

Докъде е стигнал

v0.2.2 е ранно издание от септември 2026. Това, което работи днес, е отделено от това, което още е планирано.

Налично сега

  • Памет, припомняне и учене с одобрение
  • Сканиране на проекти и документи
  • 78 вградени инструмента, MCP сървъри и три нива на разрешения
  • Режими на поверителност private, research и open
  • Карта на паметта
  • Глас в Linux
  • Home Assistant и имейл
  • Издания за Linux и Windows

Планирано

  • Собствен прозорец в Windows
  • Памет върху няколко диска
  • Повече източници за учене, например история на браузъра и имейл
  • Хостнати доставчици, тествани срещу истинските услуги; днес се тестват срещу заместители
  • Сдвояване на телефон и тунел през интернет; днес и двете работят в една мрежа

Стек

  • Go
  • SQLite
  • Ollama
  • GTK 3 and WebKitGTK
  • whisper.cpp
  • Piper
  • three.js

Пуснете го на собствения си компютър

Безплатен и с отворен код под лиценз MIT. Изтеглете изданието за Linux или Windows, прочетете ръководството или разгледайте кода в GitHub. PN Scripts може и да го адаптира за вашия екип като платена работа.

Въпроси

В частен режим, който е по подразбиране, нищо от разговорите ви. Режимът research праща заявки за търсене и изтегля страници. Режимът open праща съобщенията ви и паметта, извлечена за този ход, към избрания от вас хостнат доставчик; базата данни на паметта остава на компютъра ви. Отделно от това проверките за обновления и списъците с модели се теглят онлайн, освен ако не изключите "търси онлайн".

Да, при настройката по подразбиране "действа свободно". Всяко извикване се записва, а последните 60 променени файла се пазят до 14 дни, така че промяната може да се върне. Ако искате първо да потвърждавате, изберете в Разрешения "пита всеки път" или "пита за останалото"; всяка възможност може да се настрои и отделно.

Да. Изговорените ходове получават същите инструменти като написаните, при същата настройка за разрешения. Задайте в Разрешения да пита, ако искате да потвърждавате какво прави изговорена заявка.

Ollama с модел за разговор и nomic-embed-text и 64-битов компютър с Linux или Windows 10 или по-нов. В Linux прозорецът изисква WebKitGTK 4.1 и GTK 3. За глас са нужни whisper.cpp за слушане и Piper, espeak-ng или speech-dispatcher за говорене. Doctor проверява всичко това.

Не и само на процесор. На четири ядра със 7B модел кратък отговор отнема около 7 секунди, ход с инструменти около минута, а първият ход след пускане може да отнеме минути. Видеокарта, по-малък модел или хостнат модел в режим open са по-бързи.

Не. Linux получава собствения прозорец, гласа, управлението на работния плот и ограничението. В Windows се отваря в браузъра и пишете. Изпълнимите файлове още не са подписани, затова Windows може да предупреди при първото отваряне.

В папка, маркирана с .brain-root.json, по подразбиране в ~/.local/share/pn-scripts-assistant в Linux. Той търси този маркер на всеки монтиран диск, така че паметта може да е на външен диск. Настройките се пазят до нея в brain.conf.

В режим open, с ваш ключ: Anthropic, OpenAI, OpenRouter, Google, Groq, DeepSeek, Mistral, xAI, Together, Fireworks, Cerebras и Perplexity. Във v0.2.2 те са тествани срещу заместители, а не срещу истинските услуги.

Нищо. С отворен код е, под лиценз MIT. Хостнатите доставчици в режим open ви таксуват за собствения си API. PN Scripts може да го адаптира за вашия екип или проект като платена работа.