Pokretanje lokalnog AI agenta na vlastitom računalu: OpenClerq u petnaestak minuta

Većina "AI asistenata" radi tako da vaše dokumente pošalje na tuđi server. Za dio posla to je sasvim u redu, a za dio potpuno neprihvatljivo — spisi klijenata, plaće, sve što pokriva ugovor o povjerljivosti.

OpenClerq je naša open-source alternativa: mali administrativni agent koji radi na vašem računalu. Alate, vještine i kontekst drži lokalno, izlaže ih kroz gateway vezan na 127.0.0.1, a sve izračune radi lokalni motor. AI objašnjava; ne računa, i vaše datoteke ne moraju nikamo otići.

Ove upute ga pokreću i rade prvi stvarni poziv. Pretpostavljaju da vam terminal nije stran, ali ništa egzotičnije od toga.

Instalacija i pokretanje gatewaya

Iz izvornog koda to su četiri naredbe i kopiranje konfiguracije. Gateway drži alate, pa se prvi pokreće — desktop aplikacija je njegov klijent, a ne obrnuto.

$ git clone https://github.com/paxamedia/OpenClerq.git && cd OpenClerq$ pnpm installPackages: +812  done in 24.1s$ cp .env.example .env$ pnpm build:gateway && pnpm build:coregateway  builtcalculation-core  compiled (rust, release)$ pnpm gatewaylistening on 127.0.0.1:18790bearer token written to ~/.clerq/gateway-tokenllm: local (ollama)   engine: rust-calc   skills: 0 loaded

Prvi poziv

Ostavite taj terminal da radi i otvorite drugi. /health je jedini endpoint koji odgovara bez tokena — zato se njime provjerava je li gateway živ prije nego što je išta drugo podešeno.

$ curl -s http://127.0.0.1:18790/health{"status":"ok","version":"0.4.0","llm":{"mode":"local","provider":"ollama"}}# sve ostalo traži bearer token$ curl -s http://127.0.0.1:18790/skillsHTTP 401  {"error":"missing or invalid bearer token"}$ curl -s -H "Authorization: Bearer $(cat ~/.clerq/gateway-token)" \>   http://127.0.0.1:18790/skills{"skills":[],"source":"~/clerq-workspace/skills"}# prazno, jer još niste napisali nijednu — to je idući tutorijal

Motor izračuna

Ovo je dio po kojem se OpenClerq razlikuje od omotača oko chata. Aritmetika ide u lokalni Rust motor, deterministički, a model se pita samo za objašnjenje. Isto pitanje dvaput daje isti broj — što se za jezični model koji zbraja ne može tvrditi.

Što sada imate, a što ne

• ▸Imate lokalni gateway s autenticiranim API-jem, deterministički kalkulator i memoriju u datoteci — sve na svom računalu.
• ▸Nemate nijednu vještinu. Open-source jezgra namjerno ne dolazi ni s jednom: bez profesija, bez zakonodavstava, bez pretpostavki o vašem poslu.
• ▸Izlazni HTTP je isključen dok ne postavite popis dopuštenih domena, a čitanje datoteka ograničeno je na direktorij koji sami odredite.
• ▸Desktop aplikacija nije obavezna. pnpm desktop daje Control Tower — stanje gatewaya, uređivanje vještina, memoriju, dry-run — ali sve je dostupno i preko API-ja.

Idući korak je naučiti ga nečemu. To je jedna Markdown datoteka: pogledajte kako napisati prvu vještinu. Ako prvo želite razumjeti o kakvoj je kategoriji riječ, krenite od što je Model Context Server.