SSD Nodes Learn Hosting plans →
Mwongozo Matt ConnorNa Matt Connor

Omnigent: Jinsi ya kuunganisha mawakala wa CLI

Jifunze jinsi Omnigent inavyoendesha zana zako za CLI kama Claude Code na Cursor. Pata mwongozo wa kubandika toleo 0.7.0 na mbinu za kusandukuza mawakala kwenye VPS yako.

Omnigent ni nini

Omnigent ni meta-harness ya chanzo huria: safu moja ya uelekezaji (orchestration layer) inayoendesha zana za mstari wa amri (CLIs) za wakala ambazo tayari umesakinisha. Haichukui nafasi ya Claude Code, Codex, Cursor, OpenCode, Hermes au Pi. Inazianzisha, inampa kila moja kazi, na kusimamia matokeo ndani ya kipindi kimoja (session) kwa kutumia seti moja ya sera. Databricks ilichapisha hazina (repository) hiyo mnamo Juni 2026 chini ya leseni ya Apache 2.0, na PyPI bado inakiainisha kifurushi hicho kama alpha.

Madai ya kivitendo ni madogo, na yanastahili kusemwa wazi. Unaelezea wakala mara moja, katika YAML, na unataja harness inayoiiendesha. Badilisha mstari huo mmoja na wakala huyo huyo ataendesha kwenye CLI ya muuzaji mwingine. Hakuna kingine kinachobadilika katika usanidi wako, kwa sababu Omnigent inamiliki mzunguko (loop) juu ya mawakala badala ya mzunguko ndani yao.

Meta-harness ni nini, na inatofautiana vipi na framework?

Harness ni programu inayozungushia modeli ndani ya mzunguko (loop). Inasoma prompt yako, inaita zana, inahariri faili na kutoa ripoti. Claude Code ni harness. Codex ni harness. Unaisakinisha, unaingia (log in), na inafanya kazi yenyewe.

Framework ni maktaba (library) unayoandikia msimbo. Unaiingiza (import), unafafanua hatua katika Python, na programu yako inakuwa wakala (agent). Kubadilisha mtoa huduma (vendor) hapo kunamaanisha kuhariri msimbo wako, kwa sababu mteja wa mtoa huduma huyo ameingizwa ndani ya programu yako.

Meta-harness inakaa ngazi moja juu ya vyote viwili. Ni msimamizi anayeendesha harness kama michakato tanzu (child processes). Omnigent inaanza CLI ya mtoa huduma, inaikabidhi kazi, na kusoma kinachorejeshwa. Unabaki na CLI uliyokwisha isakinisha, na unabaki na usajili au API (application programming interface) key yoyote inayolipiwa. Huo ndio utofauti wote, na unaamua chombo hicho ni kwa ajili ya nani: watu walio na CLI za wakala kadhaa zinazofanya kazi tayari, ambao wamechoka kuziendesha kwa kutumia terminal moja baada ya nyingine.

Je, safu ya orchestration hutatua tatizo gani?

  • Gharama za kuhama mtoa huduma ni mstari mmoja. Ufafanuzi wa agent unashikilia harness na model kama data, kwa hivyo kuhamisha jukumu kutoka kwa mtoa huduma mmoja kwenda mwingine ni kuhariri faili ya YAML, si kuandika upya.
  • Uhakiki unaweza kuvuka watoa huduma. Diff iliyoandikwa na model moja husomwa na model kutoka kampuni tofauti. Model mbili kutoka familia moja huwa na mapungufu yanayofanana, kwa hivyo maoni ya pili kutoka kwa mtoa huduma yuleyule hayana thamani kubwa.
  • Sera ina makazi moja. Vizingiti vya bajeti na maombi ya idhini hutangazwa kwenye faili ya agent, na hutumika kwa kila sub-agent iliyo chini yake.
  • Kikao hudumu zaidi ya zana yoyote moja. Transcript moja inashughulikia kazi iliyofanywa na CLI kadhaa, kwa hivyo unaweza kusoma yaliyotokea bila kuunganisha scrollback nne tofauti.

Gharama ni safu yenyewe. Kila mdudu (bug) katika Omnigent sasa ni mdudu aliyepo kati yako na agent aliyekuwa akifanya kazi peke yake. Katika hatua ya alpha, hii ni gharama halisi, si ya kinadharia.

Mahali ambapo mfumo wa mawakala wengi (multi-agent harness) unapoingiliana na zana za wakala mmoja

Ikiwa bado hujaendesha wakala mmoja kwenye seva, anza hapo kwanza. Mwongozo wetu wa kuendesha wakala wa usimbaji kwenye VPS unashughulikia kisa cha wakala mmoja kikamilifu, na huo ndio usanidi ambao Omnigent inadhani tayari unao. Uwanja mpana wa mawakala wa AI wanaojiendesha (self-hosted) ndipo unapochagua mawakala wenyewe, na kujifunza jinsi mawakala wanavyofanya kazi kwa hakika ndiyo hatua ya kwanza bora zaidi ikiwa msamiati huu ni mpya kwako.

Omnigent pia ni mhimili tofauti na safu ya kiunganishi (connector layer). Kazi kama kuwapa mawakala uwezo wa kufikia vyanzo vyako vya data inahusu kile ambacho wakala anaweza kukifikia. Omnigent inahusu ni wakala yupi anayeendesha, kwa mpangilio upi, na chini ya mipaka ipi. Unaweza kuhitaji vyote viwili kwa wakati mmoja, na havipishani.

Mahitaji kabla ya kusakinisha

  • Python 3.12 au toleo jipya zaidi. Kifurushi kilichochapishwa kinatangaza requires-python >= 3.12.
  • tmux, kwa sababu mifumo ya uendeshaji (harnesses) ya terminal huendeshwa ndani yake.
  • Angalau CLI moja ya mtoa huduma, ambayo imeshasakinishwa na kuingia kwenye akaunti.
  • Node.js 22 au toleo jipya zaidi pamoja na npm, kwa sababu mifumo ya Claude, Codex na Pi inavihitaji. Kisakinishi hukagua Node 22.10 au toleo jipya zaidi na kutoa onyo ikiwa haipo. Omnigent yenyewe haihitaji Node: wheel iliyo kwenye PyPI husafirisha rasilimali za wavuti zilizojengwa tayari, na ni ujenzi kutoka kwa git checkout pekee unaofanya Node kuwa hitaji la lazima.

Sakinisha toleo lililofungwa (pinned release), si main

curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh -s -- --version 0.7.0

Sehemu ya sh -s -- siyo mapambo. Bila hiyo, sh inasoma --version kama chaguo lake lenyewe na kisakinishi hakianza kabisa. Wakati sh ikiwa ni Bash, inachapisha toleo la Bash yenyewe na kutoka kwa mafanikio, kwa hivyo hakuna kinachosakinishwa na hakuna onyo lolote. Kwa -s --, sh inasoma hati kutoka kwenye pipe na kupitisha --version 0.7.0 kwa kisakinishi. Kwenye hazina (repository) inayotoa mabadiliko makubwa kila baada ya wiki chache, huo ndio utofauti kati ya seva inayoweza kurudiwa (reproducible) na mshangao usiotarajiwa.

Toleo 0.7.0 bado limechapishwa kwenye PyPI kufikia tarehe 29 Oktoba 2026, lakini toleo jipya zaidi sasa ni 0.22.0, la tarehe 13 Novemba 2026. Toleo la awali la 0.19.1 ni kiraka (patch) kinacholenga usalama bila vipengele vipya: linasasisha dependencies baada ya kuvamiwa (compromise) kwa mamlaka ya cheti cha kati cha eMudhra, na mradi unapendekeza kusasisha. Kinachojalisha ni kufunga toleo (pin), si namba: funga toleo ulilolijaribu, na usome mabadiliko makubwa katika maelezo ya toleo (release notes) kabla ya kulibadilisha. Hata hivyo, kufunga toleo si sababu ya kuruka toleo la usalama, kwa hivyo lihamishe wakati toleo jipya la usalama linapotoka.

Kisakinishi kinatumia uv, meneja wa vifurushi vya Python wa Astral, na kinatoa ofa ya kusakinisha uv kwanza ikiwa haipo. Ikiwa uv tayari ipo, ruka hati hiyo:

uv tool install --force --python 3.12 "omnigent==0.7.0"

Viongezeo (extras) hufuata muundo uleule, na flag hurudiwa: --extra e2b --extra kubernetes kwenye hati, au "omnigent[e2b,kubernetes]" na uv. Hati hiyo pia huongeza nyongeza ya databricks isipokuwa ukipitisha --no-databricks, wakati mstari wa uv hapo juu unasakinisha kifurushi bila hiyo. Kumbuka kuwa git tag ni v0.7.0 wakati toleo la kifurushi kwenye PyPI ni 0.7.0.

uv huweka binary kwenye saraka (directory) ambayo uv tool dir --bin inaripoti, kwa kawaida ~/.local/bin, na kisakinishi hutoa ofa ya kuongeza hiyo kwenye shell profile yako. Ikiwa amri haipatikani mara tu baada ya usakinishaji safi, hiyo ndiyo sababu. Angalia ulichomaliza nacho:

omni upgrade --check

Hiyo inalinganisha toleo lililosakinishwa dhidi ya toleo la hivi karibuni lililochapishwa na kukuambia ikiwa kuna sasisho, bila kulitekeleza. omni na omnigent ni programu moja chini ya majina mawili.

Elekeza kwenye mtoa huduma wa model

omni setup

Mchawi (wizard) hutafuta vitambulisho vilivyopo tayari kwenye mazingira yako na kukuuliza vile vinavyokosekana. Hushughulikia API keys, usajili wa watoa huduma, gateways kama OpenRouter au Ollama, na Databricks workspaces. Ikiwa tayari unaendesha seva ya model ya ndani kwa kutumia Ollama kwenye mashine hiyo hiyo, elekeza gateway kwenye hiyo na trafiki haitatoka nje ya mashine hiyo.

Uendeshaji mdogo wa mawakala wengi

Mawakala wa mfano wanapatikana kwenye hazina (repository), kwa hivyo clone tag ileile uliyoiweka badala ya main.

git clone --depth 1 --branch v0.7.0 https://github.com/omnigent-ai/omnigent.git
cd omnigent
omnigent run examples/polly/

Polly ni mratibu wa uandishi wa msimbo wa mawakala wengi (multi-agent coding orchestrator) anayekuja na hazina hiyo. Usanidi wake unatangaza mawakala wadogo (sub-agents) waliopewa majina claude_code, codex, opencode, cursor, hermes na pi, pamoja na sheria moja inayofanya zoezi hili kuwa la maana: ukaguzi hufanywa kila wakati na mtoa huduma (vendor) tofauti na yule aliyetekeleza kazi. Polly haandiki msimbo wowote mwenyewe. Yeye hupanga, hugawanya lengo katika vipengele vya kazi, humkabidhi kila mmoja, na kuelekeza kila diff kwa mkaguzi kutoka kwa mtoa huduma mwingine.

Kabla ya kukabidhi chochote, Polly huendesha ukaguzi wa awali (preflight check) ili kuona ni CLI zipi za mawakala wadogo zilizopo kwenye mashine. Kwa kuwa na CLI ya mtoa huduma mmoja tu iliyowekwa, hakuna mtu wa kukabidhiwa diff hiyo, kwa hivyo weka angalau mbili kabla ya kuhukumu matokeo. Debby, mfano mwingine unaokuja na programu hii, ni wakala wa mjadala mwenye vichwa viwili, kimoja kikiwa Claude na kingine GPT:

omni debby

Hii ni njia fupi ya kuthibitisha kuwa watoa huduma wawili wamesanidiwa, kwa sababu inahitaji wote wawili ili kusema chochote.

Sub-agents wanatangazwa kama zana

Faili la wakala ni YAML. executor hutaja harness, model, na uthibitishaji. tools huhifadhi seva za MCP (model context protocol), vitendaji vya Python, na sub-agents. Sub-agent ni zana yenye type: agent na mtendaji wake yenyewe, ambayo ndiyo utaratibu uliopo nyuma ya kila kitu hapo juu.

name: orchestrator
prompt: |
  You coordinate coding and review tasks.

executor:
  harness: claude-sdk
  model: databricks-claude-sonnet-4-6

tools:
  coder:
    type: agent
    prompt: Write and test code.
    executor:
      harness: claude-sdk
      model: databricks-claude-opus-4-7
  reviewer:
    type: agent
    prompt: Review proposed changes.
    executor:
      harness: claude-sdk
      model: databricks-claude-sonnet-4-6
omnigent run path/to/my_agent.yaml

Vitambulisho hivyo vya model vinatoka kwenye docs/AGENT_YAML_SPEC.md ya mfano ya mradi wenyewe, na ni majina yanayohifadhiwa na Databricks. Badilisha harness na model na chochote ambacho omni setup imesanidi kwenye mashine yako. Thamani nyingine za harness katika spec ni pamoja na antigravity, copilot, kimi na qwen. Spec ya sasa kwenye main pia inaandika acp:<slug> kwa seva yoyote ya Agent Client Protocol, lakini spec ya v0.7.0 haiorodheshwi, kwa hivyo thibitisha kuwa inafanya kazi kwenye toleo lako ulilolifunga (pinned) kabla ya kuitegemea. Spec pia inasaidia pass_history: true kwenye sub-agent, ambayo huikabidhi mazungumzo ya mzazi (parent conversation). Hilo hugharimu token katika kila makabidhiano, kwa hivyo iache ikiwa imezimwa kwa sub-agents zinazohitaji tu kazi iliyo mbele yao. Msimbaji (coder) ambaye prompt yake inamwambia atengeneze mabadiliko madogo zaidi yanayofanya kazi humkabidhi mkaguzi wake diff fupi ya kutosha kusomeka, jambo ambalo ni muhimu zaidi hapa kuliko model unayochagua kwa jukumu lolote kati ya hayo.

Kwa nini orchestration inayochukua muda mrefu inafaa kwenye VPS

Uendeshaji wa multi-agent si amri ya dakika mbili. Inahitaji kupanga, kukabidhi, kusubiri kazi za parallel git worktrees, kupitia, na kurekebisha. Kufunga mfuniko wa laptop husitisha kila kitu. VPS (virtual private server) huendelea kuwaka na kudumisha mtandao wake, hivyo session huendelea kuwepo hata wakati huangalii.

omnigent server --background
omnigent server status

Seva huendesha kiolesura cha mtumiaji (web UI) kwenye port 6767. omnigent server status huripoti kama kuna moja inayoendelea, na omnigent stop huizima. v0.7.0 iliondoa omni server start kwa ajili ya omni server --background; v0.9.0 ilirejesha kama alias inayopaswa kuacha kutumika (deprecated).

Usichapishe 6767 kwenye anwani ya umma. Kuna njia mbili salama. Acha port hiyo ikiwa imefungwa kwenye firewall na uifanye forward kupitia SSH kwa kutumia ssh -N -L 6767:localhost:6767 you@your-server, kisha fungua kiolesura cha mtandao kwenye http://localhost:6767 kwenye mashine yako mwenyewe. Au fanya TLS (transport layer security) termination mbele yake na uwashe uthibitishaji (authentication):

OMNIGENT_AUTH_ENABLED=1 omnigent server --background

Sehemu ya firewall ya hilo ni kazi ya kawaida, iliyofafanuliwa katika misingi ya ufw firewall kwa VPS, na ikiwa seva tayari inaendesha containers nyuma ya Traefik mbele ya programu kadhaa za Docker Compose basi Omnigent ni huduma nyingine tu katika muundo huo huo.

Kwa deploy ya container, saraka ya deploy/docker/ ya repository ina usanidi wa Compose: ./bootstrap.sh hutengeneza siri (secrets) ndani ya .env, kisha docker compose up -d huanzisha Omnigent na Postgres, huku seva ikiwa kwenye port 8000 badala ya 6767. OMNIGENT_PORT hubadilisha port hiyo ya host. Compose huhesabu DATABASE_URL kwa ajili yako (kwenye malengo mengine ya deploy variable hiyo hiyo huchagua Postgres au SQLite), na OMNIGENT_AUTH_ENABLED huwa na thamani chaguo-msingi ya 1 ndani ya containers, ambayo ndiyo chaguo sahihi kwa chochote kinachoweza kufikiwa kutoka nje.

Kuhusu ukubwa, maelezo ya deploy yanaweka matumizi ya kumbukumbu ya seva wakati haifanyi kazi (idle) kwenye takriban 275 MB RSS, na usanidi wa Fly.io hupanga mashine ya 1 GB. Kipimo cha idle ni kwa ajili ya supervisor pekee; 1 GB ni kumbukumbu iliyotengwa kwa ajili ya mashine. Sub-agents wanaweza kushiriki saraka ya kazi na mazingira ya mzazi, ikiwemo sandbox yake kupitia os_env: inherit. Git worktrees tofauti ni chaguo la orchestration, kwa hivyo panga ukubwa wa seva kulingana na harnesses na agents unaoendesha kwa wakati mmoja. Seva ikishawaka, omnigent login https://your-host ikifuatiwa na omnigent host https://your-host husajili laptop yako dhidi yake, na omnigent attach <session_id> huchukua session inayoendelea kutoka kwenye kifaa kingine.

Weka kila sub-agent kwenye sandbox kabla ya kuondoka

Omnigent husafirisha sandbox ya kiwango cha mfumo wa uendeshaji inayoitwa Omnibox. Kwenye Linux, hutumia bubblewrap namespaces pamoja na seccomp, hivyo kernel ndiyo inayotekeleza mipaka badala ya prompt ya agent. Agent aliyedungwa prompt (prompt-injected) hawezi kujitoa nje ya sheria ya kernel. Sakinisha dependency kwanza:

sudo apt install bubblewrap

Usanidi unapatikana chini ya os_env katika faili ya agent:

os_env:
  type: caller_process
  cwd: .
  sandbox:
    type: linux_bwrap
    write_paths: [.]
    write_files: []
    read_paths: []
    allow_network: true
    cwd_allow_hidden: [.venv]
    env_passthrough: []
    egress_rules: []
    credential_proxy: []

Saraka ya kazi (working directory) inasomeka tu (read-only) hadi utakapoiainisha katika write_paths, kwa hivyo agent anayepata hitilafu hawezi kuandika nje ya workspace. Dotfiles za ngazi ya juu chini ya saraka ya kazi na kila mzizi wa read_paths hubaki zimefichwa isipokuwa zikitajwa katika cwd_allow_hidden, jambo linalomaanisha kuwa ruhusa pana ya kusoma haifichui kimyakimya saraka za ngazi ya juu za .ssh au .aws. Dotfiles zilizopo ndani ya saraka nyingine hubaki zikionekana kwa chaguo-msingi; weka cwd_hidden_scan_recursive: true ili kuzificha katika mti mzima wa saraka. Weka egress_rules na trafiki yote ya HTTP na HTTPS itapita kwenye proxy ya default deny, huku kila sheria ikiandikwa kama "METHODS host/path-glob". credential_proxy huenda hatua moja zaidi: agent anashikilia tu placeholder, na proxy hubadilisha na kuweka secret halisi wakati ombi linapotoka, kwa hivyo transcript iliyovuja haivuji kitu chochote kinachoweza kutumika. Katika usanidi wa multi-harness, kila sub-agent hubeba sandbox block yake katika faili lake la usanidi chini ya agents/, ili mkaguzi aweze kunyimwa mtandao wakati mtekelezaji anauweka.

Kikomo kimeelezwa katika nyaraka, na ni muhimu. Sandbox ya OS inatumika kwa wito wa zana (tool calls) za sys_os_* na kwa terminal. Haifuniki seva za MCP, na haifuniki mchakato wa supervisor wa Omnigent wenyewe. Seva ya MCP uliyoianzisha inaendeshwa nje ya sandbox kwa kutumia ruhusa zako. Pengo hilo ndilo sababu muundo thabiti zaidi bado ni mashine moja ya kutupwa (throwaway machine) kwa kila agent, ambayo ndiyo mada ya kuendesha coding agents kwenye VM inayoweza kutupwa. Nusu nyingine ya kazi ni vitambulisho (credentials), na kuweka siri nje ya uwezo wa agent inakuwa ngumu zaidi, si rahisi, wakati sub-agents sita wanashiriki host moja.

Vizingiti vya matumizi (spend thresholds) ni sera, zilizotangazwa katika faili hilohilo:

policies:
  budget:
    type: function
    handler: omnigent.policies.builtins.cost.cost_budget
    factory_params:
      max_cost_usd: 5.00
      ask_thresholds_usd: [1.00, 3.00]

Sera ya cost_budget huuliza kwenye vizingiti laini (soft thresholds) na kuzuia mifano yote (models) katika max_cost_usd kwa chaguo-msingi. Kuweka orodha isiyo tupu ya expensive_models hubadilisha kikomo kuwa lango la kushusha daraja (downgrade gate): mifano iliyo nje ya orodha hiyo inaweza kuendelea kutumia fedha. Run inayopanga na vendor mmoja, inayotekeleza na wa pili, na inayokagua na wa tatu inatumia fedha katika maeneo matatu kwa wakati mmoja, kwa hivyo weka vizingiti kabla ya run ya kwanza isiyosimamiwa badala ya baada ya ankara ya kwanza. Vipengele vilivyojengewa ndani pia vinajumuisha max_tool_calls_per_session na ask_on_os_tools, ambavyo huomba idhini kabla ya shughuli za faili na shell. Vidokezo vyetu kuhusu kudhibiti gharama za AI agent kwenye VPS vinatumika moja kwa moja hapa, na vinatumika kwa nguvu zaidi, kwa sababu sub-agents wanaoendeshwa sambamba huongeza kasi ya matumizi ya fedha.

Je, hazina hii inakua kwa kasi kiasi gani?

ChatiDays between tagged Omnigent releases, v0.2.0 to v0.7.0
Data iliyo nyuma ya chati hii
[
  {
    "version": "v0.2.0",
    "released": "2026-06-19",
    "interval": 3
  },
  {
    "version": "v0.3.0",
    "released": "2026-06-27",
    "interval": 8
  },
  {
    "version": "v0.4.0",
    "released": "2026-07-03",
    "interval": 6
  },
  {
    "version": "v0.5.0",
    "released": "2026-07-10",
    "interval": 7
  },
  {
    "version": "v0.5.1",
    "released": "2026-07-10",
    "interval": 0
  },
  {
    "version": "v0.6.0",
    "released": "2026-07-21",
    "interval": 11
  },
  {
    "version": "v0.7.0",
    "released": "2026-07-27",
    "interval": 6
  }
]

Hizo ni tarehe za matoleo yaliyochapishwa kutoka kwenye ukurasa wa releases wa mradi wenyewe, yaliyosomwa tarehe 3 Agosti 2026. 7 releases zilizowekewa tag zilitoka kati ya 2026-06-19 na 2026-07-27, na pengo refu zaidi kati ya matoleo yoyote mawili lilikuwa siku 11. v0.5.1 ilitoka siku moja na toleo lililotangulia. Matoleo mawili ya kwanza ya PyPI, 0.1.0 mnamo 13 Juni 2026 na 0.1.1 mnamo 16 Juni 2026, hayana kumbukumbu kwenye ukurasa wa GitHub releases na hayakujumuishwa kwenye chati; siku tatu zilizoonyeshwa kwa v0.2.0 zinahesabiwa kuanzia 0.1.1.

Matoleo mawili kati ya hayo yalibadilisha amri ambazo miongozo ilikuwa imeshaziorodhesha. v0.7.0 iliondoa omni server start kwa ajili ya omni server --background. v0.6.0 ilibadilisha jina la extra omnigent[memory] kuwa omnigent[hindsight], lakini ilihifadhi memory kama alias ya utangamano iliyofanya kazi hadi 0.10.0. Kuanzia 0.11.0, iliyotolewa 25 Agosti 2026, alias hiyo haipo tena, kwa hivyo mstari wa usakinishaji uliokopiwa kutoka kwenye makala ya Juni hauvuti tena Hindsight client. Hii ndiyo sababu ya kutumia --version katika amri yako ya usakinishaji na kuweka tag kwenye git clone yako, si suala la upendeleo wa mtindo.

Kasi haijapungua tangu usomaji huo. Kufikia 29 Oktoba 2026, PyPI inaorodhesha 0.20.0, iliyotolewa 28 Oktoba, ikiwa ni matoleo madogo kumi na matatu baada ya 0.7.0, na maelezo ya toleo la mradi yanaashiria mabadiliko makubwa (breaking changes) katika kadhaa kati yao. Mabadiliko mawili ni muhimu kwa chochote kilichokopiwa kutoka ukurasa huu: v0.12.0 ilifanya omni tupu kuanzisha background host badala ya Polly agent (omni run sasa huzindua agent chaguo-msingi), na v0.13.0 inahitaji tmux 3.3 au mpya zaidi kwa ajili ya managed terminals.

Mambo ambayo bado siwezi kuiamini

Kufikia tarehe 27 Oktoba 2026, hazina hii ina takriban nyota 11k, forks 1.8k, na masuala (issues) 910 yaliyo wazi, huku toleo la kwanza la umma likiwa na umri wa miezi minne tu. Nyota hupima hamu ya watu, na hamu si uthibitisho wa ukomavu. Mradi huu unajitambulisha kama alpha, na historia ya matoleo iliyo hapo juu inaonyesha kuwa ni alpha kweli.

  • Siwezi kuiendesha kwenye seva inayohifadhi vitambulisho vya uzalishaji (production credentials), kwa sababu sandbox haijajumuisha seva za MCP au msimamizi (supervisor).
  • Siwezi kuacha mchakato ukiendelea bila usimamizi bila sera ya cost_budget, kwa sababu watoa huduma watatu wanaweza kutoza gharama kwa wakati mmoja; ukiwa na orodha ya expensive_models isiyo tupu, matumizi yanaweza kuendelea kwenye mifano ya bei nafuu.
  • Siwezi kuweka seva kwenye anwani ya IP ya umma bila OMNIGENT_AUTH_ENABLED kuwekwa na TLS mbele yake.
  • Siwezi kuchukulia YAML ya wakala kama kitu thabiti katika matoleo madogo (minor versions) bado, kwa hivyo funga (pin) toleo unalotumia na usome maelezo ya toleo kabla ya kufanya upgrade.

Jambo moja zaidi la kujua kabla halijakushangaza: v0.6.0 iliongeza telemetry ya matumizi iliyofichwa utambulisho, README inasema inakusanywa kwa chaguo-msingi, na mradi huu unaelezea jambo hilo, ikiwemo jinsi ya kujiondoa, kwenye ukurasa maalum wa telemetry. Soma ukurasa huo na ufanye uamuzi wako kwa makini ikiwa mashine hiyo inashughulikia kazi za wateja.

Kitu ambacho Omnigent ni hodari nacho kweli leo ni kile ilichoundwa kwa ajili yake. Una CLI za mawakala watatu au wanne, tayari unawalipia, na unataka mmoja wao aandike huku mwingine akipitia kazi hiyo. Hilo linafanya kazi sasa, kwenye mashine moja, na sandboxing halisi kwenye Linux. Chukulia kila kitu kingine zaidi ya hapo kama kitu cha kuahidi lakini ambacho hakijakamilika.

FAQ

Je, Omnigent ni wakala, au ni kitu kinachoendesha mawakala?

Inaendesha mawakala. Omnigent ni meta-harness: inaanza CLIs za watoa huduma ulizokwishasakinisha, kama vile Claude Code, Codex au OpenCode, inampa kila mmoja kazi, na kusimamia matokeo katika kipindi kimoja. Haina mfano (model) wake yenyewe. Hii ndiyo sababu inatofautiana na mfumo (framework), ambapo unaandika Python dhidi ya maktaba na programu yako mwenyewe inakuwa wakala.

Je, nahitaji Claude Code na Codex ziwe zimesakinishwa kabla ya Omnigent kuwa na manufaa?

Unahitaji angalau CLI moja ya mtoa huduma iliyosakinishwa na kuingia (logged in), kwa sababu Omnigent huendesha programu hizo badala ya kuzibadilisha. Kwa mfano wa Polly uliotolewa, unahitaji mbili au zaidi kutoka kwa watoa huduma tofauti. Kanuni ya Polly ni kwamba uhakiki hufanywa kila wakati na mtoa huduma tofauti na yule aliyetekeleza, kwa hivyo ukiwa na CLI moja tu, hakuna mtoa huduma wa pili wa kutuma diff hiyo.

Ninawezaje kusakinisha toleo mahususi la Omnigent badala ya la hivi karibuni?

Peleka --version kupitia hati ya usakinishaji ukiwa na sh -s --, kama ilivyo katika sh -s -- --version 0.7.0. Bila -s --, sh huchukua --version kama chaguo lake lenyewe na kisakinishi hakiendi: Bash, kwa mfano, huchapisha toleo lake na kutoka. Ukiwa na uv iliyopo tayari, uv tool install --force --python 3.12 "omnigent==0.7.0" hufanya kazi hiyo hiyo. Lebo ya git ni v0.7.0 wakati kamba ya toleo la PyPI ni 0.7.0.

Je, sandbox ya Omnibox inatosha kuendesha mawakala bila kusimamiwa?

Ni imara kwa kile inachokifunika na iko wazi kuhusu kile isichokifanya. Kwenye Linux hutumia bubblewrap pamoja na seccomp, kwa hivyo kernel hutekeleza vikwazo vya faili na mtandao na wakala hawezi kujiondoa. Nyaraka zinasema kuwa inatumika kwa wito wa zana wa sys_os_* na terminal, na kwamba haifuniki seva za MCP au mchakato wa msimamizi wa Omnigent. Kwa hivyo, seva ya MCP huendesha kwa ruhusa zako za kawaida, ndiyo sababu mashine pepe (virtual machine) inayoweza kutupwa kwa kila wakala inabaki kuwa njia imara zaidi ya kutenga kazi zisizosimamiwa.

Seva ya Omnigent inahitaji kumbukumbu kiasi gani kwenye VPS?

Maelezo ya deploy ya mradi huu yanaripoti takriban 275 MB RSS wakati haifanyi kazi, na usanidi wake wa Fly.io hutenga mashine ya 1 GB. Kipimo cha kutofanya kazi kinashughulikia seva pekee, si mawakala wake wadogo. Mawakala wadogo wanaweza kushiriki saraka ya kazi ya mzazi na mazingira, ikijumuisha sandbox yake kupitia os_env: inherit; nakala tofauti za kazi hazihakikishiwi. Uendeshaji wa mtindo wa Polly hutumia worktrees za git sambamba, kwa hivyo panga ukubwa wa RAM na diski kulingana na idadi ya mawakala unaopanga kuendesha kwa wakati mmoja badala ya seva.

Je, makala hii ilikusaidia?