გარემოს ცვლადები

database value  →  environment variable  →  built-in default

# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes

AiHummer კონფიგურირდება `AIHUMMER_*` გარემოს ცვლადებით (პლუს რამდენიმე ხელსაწყო-სპეციფიკური, როგორიცაა `SEARXNG_URL`). ეს გვერდი არის კატალოგი, დაჯგუფებული სფეროების მიხედვით. ცვლადების უმეტესობა ასევე რედაქტირებადია ვებ ადმინ UI-დან. ## კონფიგურაციის მოდელი ყველა პარამეტრი წყდება ფიქსირებული თანმიმდევრობით: ```text database value → environment variable → built-in default ``` ეს ნიშნავს, რომ ადმინ UI-ში შენახული მნიშვნელობა (შენახული ბაზაში) გადააჭარბებს გარემოს, რომელიც გადააჭარბებს ჩაშენებულ ნაგულისხმევს. **Bootstrap ცვლადები** — ისინი, რომლებიც gateway-ს სჭირდება ბაზის წაკითხვამდე, როგორიცაა `AIHUMMER_DATABASE_URL` და `AIHUMMER_MASTER_KEY` — რჩება **მხოლოდ-გარემოს** დონეზე. ჰოსტ-მშობლიური ინსტალაციის კონფიგურაციის ფაილი მდებარეობს: ```ini # /home/.aihummer/etc/gateway.env AIHUMMER_DATABASE_URL=postgres://... AIHUMMER_MASTER_KEY=base64-32-bytes ``` > [!TIP] > მორგებადი, არა-bootstrap პარამეტრები უმჯობესია შეიცვალოს ვებ ადმინ UI-ში, რათა > ისინი ამოქმედდეს ფაილების რედაქტირების გარეშე. ზოგი ცვლილება (როგორიცაა ხელსაწყოს > ჩამრთველები და ქვე-აგენტის სიღრმე) მოქმედებს ცხლად; სხვებს სჭირდება სერვისის გადატვირთვა. ## ბირთვი და ბაზა | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_DATABASE_URL` | **სავალდებულო.** Postgres DSN. ამის გარეშე gateway მუშაობს მხოლოდ-ჯანმრთელობის რეჟიმში. | | `AIHUMMER_DB_APP_URL` | შეზღუდული-როლის DSN, რომელიც ააქტიურებს Row-Level Security-ს (ავტომატურად დაყენებული ლოკალური ინსტალაციებისთვის). | | `AIHUMMER_GATEWAY_ADDR` | მოსასმენი მისამართი (ნაგულისხმევი `:8780`; ინსტალატორი ირჩევს თავისუფალ პორტს). | | `AIHUMMER_DEFAULT_WORKSPACE_ID` | ჩართავს შემომავალ დისპეტჩერს და ვიჯეტის ნაგულისხმევ სამუშაო სივრცეს. | | `AIHUMMER_BLOB_DIR` | ჩართავს მედია/ფაილების სერვისს (blob საცავის დირექტორია). | | `AIHUMMER_ADMIN_UI_DIR` | ემსახურება ადმინ SPA-ს მისამართზე `/admin/`. | | `AIHUMMER_WIDGET_DIR` | ემსახურება ვებ ვიჯეტს მისამართზე `/widget/`. | ## უსაფრთხოება და საცავი | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_MASTER_KEY` | base64-კოდირებული 32 ბაიტი; ჩართავს მოსვენების მდგომარეობაში საიდუმლოებს, საცავსა და BYOK-ს. | | `AIHUMMER_MEDIA_TOKEN_SECRET` | ინახავს ხელმოწერილ ჩამოტვირთვის URL-ებს ვალიდურად გადატვირთვების შემდეგ. | | `AIHUMMER_APPROVAL_TOOLS` | ხელსაწყოები, რომლებსაც გაშვებამდე სჭირდება ადამიანის დადასტურება. | | `AIHUMMER_AIRGAPPED` | `1` ბლოკავს მოდელის მიერ კონტროლირებად საჯარო გამავალ ტრაფიკს (air-gapped რეჟიმი). | | `AIHUMMER_AUDIT_RETENTION_DAYS` | ადმინ აუდიტის ლოგის შენახვის ფანჯარა. | ## ავთენტიფიკაცია და SSO | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_OIDC_ISSUER` | იცავს `/v1/admin/*`-ს. ამის გარეშე (და LDAP/SAML-ის გარეშე) ადმინი ენდობა dev ჰედერებს — არასოდეს გამოამჟღავნო ასეთი ინსტანცია. | LDAP/AD და SAML კონფიგურირდება OIDC-თან ერთად საწარმოო შესვლისთვის; SCIM უზრუნველყოფს მომხმარებლების ავტომატურ პროვიჟენინგს. იხ. [Webhook-ები, SCIM და დაწყვილება](/ka/v1.0/api/webhooks-scim-pairing). ## არხები და შემომავალი | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_INBOUND_SECRET` | HMAC საზიარო საიდუმლო connector → gateway `/v1/inbound/*` გამოძახებებისთვის. | | `AIHUMMER_INBOUND_URL` | Connector-ის მხარეს: gateway-ის შემომავალი URL, რომელზეც connector აგზავნის. | ## LLM და მოდელები | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_LLM_PROVIDER` | გამოსაყენებელი მოდელის პროვაიდერი. | | `AIHUMMER_LLM_MODEL` | მოდელის სახელი. | | `AIHUMMER_LLM_GATEWAY_URL` | წერტილი OpenAI-თავსებადი LLM gateway-ისთვის. | | `AIHUMMER_OPENAI_API_KEY` | API გასაღები OpenAI-თავსებადი პროვაიდერისთვის. | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | წარმოქმნილი ქვე-აგენტების მაქსიმალური სიღრმე. | > [!NOTE] > თუ მოდელი არ არის შეერთებული, gateway უბრუნდება **დეტერმინისტულ მოკ-ს**, რათა > სისტემა მაინც იმუშაოს. ფასიანი მოდელის API არასოდეს არის სავალდებულო — უფასო/ლოკალური > მოდელები და Codex/ChatGPT-გამოწერის ტრანსპორტი პირველი კლასისაა. ## ხელსაწყოები | ცვლადი | დანიშნულება | |---|---| | `SEARXNG_URL` | ჩართავს `web_search` ხელსაწყოს (SearXNG ინსტანციის URL). | | `CLOAKBROWSER_CDP_URL` | ჩართავს `browser`/`computer` ხელსაწყოებს (Chrome DevTools Protocol URL). | | `AIHUMMER_FS_ROOT` | ჩართავს `filesystem_read`-ს, sandbox-ში ამ root-ის ქვეშ. | | `AIHUMMER_DB_QUERY_DSN` | ჩართავს `db_query`-ს (მხოლოდ-კითხვა) ამ DSN-ის წინააღმდეგ. | | `AIHUMMER_CODE_EXEC` | რთავს `code_exec` ხელსაწყოს (ნაგულისხმევად გამორთული საზიარო ჰოსტებზე). | იხ. სრული [ხელსაწყოების კატალოგი](/ka/v1.0/reference/tools-catalog) იმისთვის, თუ რას აკეთებს თითოეული ხელსაწყო. ## ხმა და sidecar-ები | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_STT_URL` | მეტყველება-ტექსტში sidecar-ის URL (ავტომატურად დაყენებული ინსტალატორის მიერ). | | `AIHUMMER_TTS_URL` | ტექსტი-მეტყველებად sidecar-ის URL (ავტომატურად დაყენებული ინსტალატორის მიერ). | | `AIHUMMER_DIARIZE_URL` | მოლაპარაკის დიარიზაციის sidecar-ის URL. | | `AIHUMMER_VOICECLONE_URL` | ხმის კლონირების sidecar-ის URL. | | `AIHUMMER_VIDEO_URL` | ვიდეო-გააზრების sidecar-ის URL. | Sidecar-ები ცალკე HTTP სერვისებია; gateway მათ აღწევს URL-ით. ## ვექტორები და ემბედინგები | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_QDRANT_URL` | ნამდვილი ვექტორული საცავი (Qdrant). არარსებობს → მეხსიერებაში საცავი. | | `AIHUMMER_EMBEDDER_URL` | ნამდვილი ემბედერის სერვისი. არარსებობს → hash ემბედერი. | ## ავტობუსი და დაკვირვებადობა | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_NATS_URL` | სურვილისამებრ NATS ავტობუსი მიწოდებისთვის. | | `AIHUMMER_OTEL_ENDPOINT` | OTLP წერტილი trace-ების/მეტრიკების ჩაგზავნისთვის. | > [!WARNING] > დაკვირვებადობა არის **მხოლოდ OTLP ჩაგზავნა**. AiHummer **არ** აქვეყნებს Prometheus > `/metrics` წერტილს ან `/debug/pprof`-ს. ამის ნაცვლად მიმართე `AIHUMMER_OTEL_ENDPOINT` > შენს კოლექტორზე. ## განახლებები | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_DOWNLOAD_BASE_URL` | საბაზისო URL რელიზის არტეფაქტებისთვის (თვით-განახლების წყარო). | | `AIHUMMER_UPDATE_CHANNEL` | რელიზის არხი თვალყურისდევნებისთვის. | | `AIHUMMER_AUTO_UPDATE` | განახლების რეჟიმი: `off`, `check` ან `apply`. | გასაღებით-დაცული ინსტალაციის არხები (alfa/beta/dev) დამატებით კითხულობენ `AIHUMMER_CHANNEL_KEY` / `AIHUMMER_RELEASE_TOKEN`-ს **ინსტალაციის დროს**. ## მარკეტფლეისი და დანამატები | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_BLOB_DIR` | Blob-საცავის დირექტორია. მედია/ფაილების გარდა, ის ინახავს **კერძო (გვერდიდან-ჩატვირთულ) დანამატის არტეფაქტებს** `blob:` მითითებების ქვეშ, რომლებსაც deployer წყვეტს. | | `AIHUMMER_PLUGIN_PUBKEY` | დამატებითი სანდო საჯარო გასაღები (base64 ed25519) დანამატის ხელმოწერების შესამოწმებლად — **დამატებით** ბირთვში მიმაგრებულ რეესტრის გასაღებთან. | | `AIHUMMER_PLUGIN_DEV_UNSIGNED` | `1` უშვებს **ხელმოუწერელი** დანამატების ინსტალაციას. მხოლოდ ლოკალური დეველოპმენტისთვის — არასოდეს გარედან წვდომად ინსტანციაზე. | ნდობის მოდელი (ოფიციალური → მიმაგრებული გასაღები, კერძო → ნდობის საცავი, ხელმოუწერელი → დაბლოკილი) აღწერილია [ინსტალაცია და განახლებები](/ka/v1.0/marketplace/install-updates#trust-model-and-the-pinned-key). ## პროტოკოლის ზედაპირები (opt-in) | ცვლადი | დანიშნულება | |---|---| | `AIHUMMER_MCP_PUBLISH` | `1` ჩართავს გარე MCP სერვერს მისამართზე `POST /v1/mcp`. | | `AIHUMMER_A2A_PUBLISH` | `1` ჩართავს A2A ზედაპირს (`/.well-known/agent.json`, `/a2a/message`). | ## სად შემდეგ - ნახე, რომელ ხელსაწყოებს ხსნის თითოეული ცვლადი: [ხელსაწყოების კატალოგი](/ka/v1.0/reference/tools-catalog). - ააწარმოე ინსტანცია ყოველდღიურად: [CLI ცნობარი](/ka/v1.0/reference/cli).