AI Layer v1.00

AI Layer je POSIX-native AI OS vrstva pre terminálové prostredia.

Poskytuje prenositeľný runtime na interakciu s lokálnymi aj vzdialenými AI modelmi priamo zo shellu.
Celý systém je implementovaný výhradne pomocou POSIX-kompatibilných shell skriptov a funguje na:

• sh
• dash
• bash
• zsh

AI Layer umožňuje AI modelom interagovať so systémom cez kontrolované nástroje, podobne ako programy používajú systémové volania v operačnom systéme.

Filozofia

AI Layer nie je AI framework.

Je to systémová vrstva, navrhnutá podľa týchto princípov:

• POSIX kompatibilita
• minimálne závislosti
• nezávislosť od providera
• nezávislosť od modelu
• nástrojovo orientovaná architektúra
• prenositeľnosť naprieč systémami

Runtime pracuje s tool callmi ako so systémovými primitívami, čím umožňuje AI modelom bezpečne interagovať s prostredím.

Prečo AI Layer vznikol

Väčšina dnešných AI nástrojov je postavená ako webová aplikácia alebo závisí od veľkých frameworkov.
Často vyžadujú zložité prostredie, množstvo závislostí a prehliadačové rozhranie.

AI Layer vznikol s cieľom vyriešiť jednoduchý problém:

Používať AI priamo z terminálu čistým, prenositeľným a kontrolovateľným spôsobom.

Projekt sa začal ako malý nástroj, ktorý mal odstrániť potrebu neustále prepínať sa do prehliadača pri práci s AI.
Počas vývoja sa však ukázalo, že jednoduchý CLI wrapper nestačí.

Bolo potrebné vytvoriť systémovú vrstvu.

AI Layer zavádza runtime, v ktorom AI interaguje so systémom cez nástroje, podobne ako programy komunikujú s operačným systémom cez systémové volania.

Namiesto vytvárania ďalšej AI aplikácie sa cieľom stalo vytvoriť AI execution layer.

Táto vrstva umožňuje:

• priamu interakciu s AI v termináli
• prístup k systému cez nástroje
• agentné workflowy
• automatizáciu a skriptovanie
• prenositeľné prostredia

Návrh sa sústreďuje na jednoduchosť a dlhodobú prenositeľnosť.

Celý systém je napísaný v POSIX shelli, takže môže fungovať takmer kdekoľvek bez úprav.

AI Layer má byť:

• malý
• prenositeľný
• transparentný
• rozšíriteľný

Namiesto skrývania správania za komplexné frameworky AI Layer vystavuje jednoduché primitíva, ktoré sa dajú kombinovať do pokročilejších workflowov.

Výsledkom je minimálna AI operating vrstva pre terminálové prostredia.

Dizajnové princípy

AI Layer sa riadi malou sadou základných návrhových pravidiel.

• POSIX na prvom mieste
  Celý systém je napísaný v POSIX shelli. Má fungovať na sh, dash, bash aj zsh bez úprav.
• Minimálne závislosti
  Runtime závisí iba od bežných UNIX nástrojov ako curl, jq, sed a awk.
• Nástrojovo orientovaná architektúra
  AI interaguje so systémom cez nástroje. Tie fungujú ako kontrolované primitíva podobné systémovým volaniam.
• Nezávislosť od providera
  AI Layer nie je viazaný na jedného AI providera. Podporuje lokálne aj vzdialené modely.
• Nezávislosť od modelu
  Runtime je navrhnutý tak, aby bolo možné meniť modely bez zmeny architektúry systému.
• Transparentnosť pred abstrakciou
  Systém uprednostňuje jednoduché shell skripty pred zložitými frameworkmi.
• Kontrola operátora
  Používateľ zostáva pánom nad prostredím aj vykonávaním.
• Prenositeľnosť
  AI Layer je navrhnutý tak, aby fungoval aj v minimalistických prostrediach, ako sú servery, kontajnery alebo vzdialené systémy.

Ciele projektu

AI Layer má poskytovať:

• AI interakciu natívnu pre terminál
• prenositeľné AI runtime prostredia
• interakciu so systémom cez nástroje
• automatizáciu a orchestráciu workflowov
• dlhodobú stabilitu bez závislosti na frameworkoch

Komponenty

AI Layer pozostáva zo štyroch hlavných príkazov.

• ai — AI runtime
• ag — terminálový agent
• at — testovací nástroj
• aw — event watcher

Spolu tvoria minimálne AI operating prostredie pre terminál.

AI Runtime (ai)

Príkaz ai je vykonávací runtime systému AI Layer.

Zodpovednosti:

• komunikácia s modelom
• vykonávanie nástrojov
• spracovanie kontextu
• logovanie
• abstrakcia providerov

Príklad použitia:

ai "Vysvetli filozofiu POSIX"

Príklad asistencie pri príkaze:

ai run cat hostory.log

Použitie konkrétneho modelu:

ai -m gpt-oss:20b "Analyzuj projekt"

Terminálový agent (ag)

Príkaz ag poskytuje viac-krokové uvažovanie a orchestráciu.

Kým ai rieši jednotlivé požiadavky, agent koordinuje viacero reasoning krokov na vyriešenie zložitejších úloh.

Režimy agenta:

• single
• multi
• repair
• inspect

Príklad:

ag -m multi "analyze project"

Príklad agent session:

ag -m multi -d "find where openai api is used"
[agent] mode=multi step=1/6
[agent] calling ai
[agent] status=TOOL
[agent] tool=grep args=-RIn "openai" .
[agent] mode=multi step=2/6
[agent] calling ai
[agent] status=FINAL

AI Tester (at)

Príkaz at je navrhnutý ako validačná súčasť AI Layeru.

Jeho cieľom je znížiť množstvo opakovaného manuálneho testovania overovaním správania runtime a správnosti workflowov.

Plánované oblasti použitia:

• validácia runtime
• testovanie správania nástrojov
• overovanie workflowov
• detekcia regresií

Príklady konceptov:

at runtime
at tools
at agent

Tester je súčasťou návrhu systému a bude sa vyvíjať spolu s rastom AI Layeru.

AI Watcher (aw)

Komponent aw je plánovaný ako vrstva na pozorovanie udalostí v AI Layere.

Jeho cieľom je sledovať systémové udalosti a spúšťať AI workflowy, keď nastanú relevantné podmienky.

Možné budúce triggre:

• zmeny súborov
• chyby v logoch
• zlyhania testov
• systémové udalosti

Príklady konceptov:

aw watch logs/history.json
aw watch project directory

Watcher je súčasťou dlhodobej architektúry a bude pridávaný podľa potreby.

Architektúra

AI Layer používa minimálnu vrstvenú architektúru.

• ai → execution runtime
• ag → reasoning orchestration
• at → validation
• aw → event observation

Táto štruktúra tvorí terminálovo natívne AI operating prostredie.

Runtime model

AI Layer oddeľuje reasoning od orchestrácie.

ai je execution runtime.

Je zodpovedný za:

• komunikáciu s modelmi
• volanie nástrojov
• spracovanie výstupov nástrojov
• generovanie odpovedí

ag je orchestration loop postavený nad ai.

Nástroje nevykonáva priamo.
Namiesto toho opakovane volá ai, zbiera výsledky krokov a buduje históriu krokov.

Toto oddelenie udržiava systém jednoduchý a predvídateľný.

ai = execution intelligence
ag = orchestration

Funkcie

• implementácia v POSIX shelli
• podpora lokálnych aj vzdialených modelov
• unifikované tool calling
• agentné execution režimy
• streamované odpovede
• logovanie nástrojov
• podpora RAG
• modelové profily
• prompt profily
• renderovanie v termináli

Systém nástrojov

AI modely interagujú s prostredím cez kontrolované nástroje.

Nástroje fungujú ako systémové primitíva podobné syscallom v operačnom systéme.

Príklady:

• tree
• grep
• cat
• find
• write_file
• append_file

Runtime tieto nástroje vystavuje modelu cez štruktúrované rozhranie.
Tým sa zabraňuje tomu, aby model priamo vykonával ľubovoľné shell príkazy.

Závislosti

AI Layer si zámerne udržiava minimálne závislosti.

Požadované nástroje:

• curl
• jq
• sed
• awk

Tieto nástroje sú bežne dostupné vo väčšine UNIX-like systémov.

Inštalácia

Spusti inštalačný skript:

sh -c "$(curl -fsSL https://pihi.sk/projects/ai_layer/netinstall.sh)"

Inštalátor:

• stiahne projekt
• pripraví konfiguračné adresáre
• nainštaluje CLI príkazy

Štruktúra projektu

ai_layer/
├── ai.sh
├── ag.sh
├── at.sh
├── aw.sh
├── config/
├── lib/
├── logs/
├── utils/
└── VERSION

Používanie AI v pipes

AI Layer sa prirodzene integruje do štandardných UNIX pipelines.

Príklady:

tail -n 20 logs/history.json | ai "summarize recent errors"

git diff | ai "review this patch"

To umožňuje, aby sa AI stala súčasťou bežných shell workflowov.

Stav

Aktuálna verzia:

AI Layer v1.00

Architektúra runtime sa považuje za stabilnú.
Ďalší vývoj sa sústredí na rozširovanie možností a workflowov.

Licencia

Informácie o licencii budú doplnené do projektu.