Sidecar-ები
ზოგიერთი შესაძლებლობა — მეტყველება, ვიდეო, ვებ ძიება, headless ბრაუზერი — არ არის თავად gateway-ის ნაწილი. ისინი მუშაობს როგორც sidecar-ები: მცირე, დამოუკიდებელი HTTP სერვისები, რომლებსაც gateway აღწევს URL-ით. ყოველი sidecar არის უფასო და ლოკალური: არცერთ მათგანის უკან არ არის სავალდებულო ფასიანი API.
რა არის sidecar
sidecar არის ცალკე პროცესი, რომელიც აქვეყნებს HTTP API-ს. gateway არასოდეს აკავშირებს მას შიგნით ან უშვებს მას in-process — ის უბრალოდ იძახებს URL-ს, რომელსაც აკონფიგურირებთ. თითოეული sidecar
- მუშაობს საკუთარი systemd unit-ის ქვეშ (ჰოსტ-მშობლიური, კონტეინერების გარეშე),
- გაყვანილია gateway-თან გარემოს ცვლადით, და
- შეიძლება დაინსტალირდეს მშობლიურად gateway-ის გვერდით, ან მიეთითოს არსებულ ინსტანციაზე, რომელსაც უკვე უშვებთ სხვაგან.
იმის გამო, რომ კონტრაქტი უბრალოდ HTTP არის, იგივე კონფიგურაცია მუშაობს იმისდა მიუხედავად, sidecar
localhost-ზეა თუ სხვა ჰოსტზე.
[!NOTE] Sidecar-ები არჩევითია. შესაძლებლობა აქტიურია მხოლოდ მაშინ, როცა მისი URL კონფიგურირებულია; მანამდე gateway მუშაობს მის გარეშე. ეს ინარჩუნებს მინიმალურ ინსტალაციას უბრალოდ gateway-ად პლუს PostgreSQL-ად.
Sidecar-ები და მათი პორტები
| პორტი | Sidecar | მხარდაჭერილია | ამუშავებს | გაყვანილია |
|---|---|---|---|---|
| 8001 | STT | faster-whisper | speech-to-text | AIHUMMER_STT_URL |
| 8002 | TTS | edge-tts | text-to-speech | AIHUMMER_TTS_URL |
| 8003 | diarize | pyannote | მოლაპარაკის დიარიზაცია | AIHUMMER_DIARIZE_URL |
| 8004 | voiceclone | OpenVoice V2 | ხმის კლონირება | AIHUMMER_VOICECLONE_URL |
| 8005 | video | ffmpeg | ვიდეოს გაგება | AIHUMMER_VIDEO_URL |
| 8888 | SearXNG | SearXNG | web_search ხელსაწყო |
SEARXNG_URL |
| 9222 | Chrome / CDP | Chrome (CDP) | browser ხელსაწყო |
CLOAKBROWSER_CDP_URL |
ხმის sidecar-ები არის out-of-the-box ბილიკი: STT (:8001) კვებავს აგენტის
ბრუნვას და TTS (:8002) ლაპარაკობს პასუხს, ორივე უფასო/ლოკალურ ძრავაზე. დიარიზაცია
(:8003), ხმის კლონირება (:8004) და ვიდეოს გაგება (:8005) არის
დამატებითი, არჩევითი sidecar-ები. SearXNG (:8888) უზრუნველყოფს web_search-ს, და
Chrome/CDP endpoint (:9222) უზრუნველყოფს browser ხელსაწყოს.
Sidecar-ების გაყვანა
თქვენ მიუთითებთ gateway-ს თითოეულ sidecar-ზე შესაბამისი გარემოს ცვლადით. ჰოსტ-მშობლიური ინსტალაციისთვის ხმის sidecar-ები (STT/TTS) კონფიგურირებულია თქვენთვის; დანარჩენი ჩართეთ საჭიროებისამებრ.
# gateway.env — voice in/out (auto-set by the installer for STT/TTS)
AIHUMMER_STT_URL=http://127.0.0.1:8001
AIHUMMER_TTS_URL=http://127.0.0.1:8002
# Optional voice/video sidecars
AIHUMMER_DIARIZE_URL=http://127.0.0.1:8003
AIHUMMER_VOICECLONE_URL=http://127.0.0.1:8004
AIHUMMER_VIDEO_URL=http://127.0.0.1:8005
# Tool sidecars
SEARXNG_URL=http://127.0.0.1:8888
CLOAKBROWSER_CDP_URL=http://127.0.0.1:9222[!TIP] იმის გამო, რომ თითოეული sidecar უბრალოდ URL-ია, შეგიძლიათ მძიმე სერვისების ცენტრალიზება. მიუთითეთ რამდენიმე gateway ერთ საზიარო STT/TTS ან SearXNG ინსტანციაზე, ვიდრე ჰოსტზე თითო ასლი გაუშვათ.
მათი მშობლიურად ან საზიაროდ გაშვება
თითოეული sidecar ცხოვრობს საკუთარი systemd unit-ის ქვეშ ჰოსტზე, ამიტომ თქვენ ოპერირებთ მას ისე, როგორც ნებისმიერ სხვა სერვისს — გაშვება, გაჩერება და ლოგების წაკითხვა gateway-ისგან დამოუკიდებლად. თუ უკვე უშვებთ, ვთქვათ, SearXNG ან Chrome/CDP endpoint-ს, უბრალოდ დააყენეთ URL ამ არსებულ ინსტანციაზე და მთლიანად გამოტოვეთ ლოკალური ინსტალაცია. ნებისმიერ შემთხვევაში gateway-ის ხედვა იდენტურია: კონფიგურირებული URL, რომელსაც მას შეუძლია გამოძახება.
[!WARNING]
browser(CDP) დაweb_searchხელსაწყოები აღწევენ ქსელს. გამყარებულ ან air-gapped დანერგვებზე გადახედეთ egress-ს და air-gapped პარამეტრს მათ ჩართვამდე — gateway იძახებს მხოლოდ იმ sidecar-ს, რომელიც გაყვანილი გაქვთ.
სად შემდეგ
- როგორ გამოიყენება ხმა და browser ხელსაწყო ბრუნვაში: Gateway და ბრუნვის ძრავა.
- მინიმალური მკაცრი დამოკიდებულება (PostgreSQL) და არჩევითი ყველაფერი დანარჩენი: Gateway და ბრუნვის ძრავა.