AiHummer
ქართული
შესვლაპირადი კაბინეტი
v1.0.x
{ }Swagger

გვერდის ეტლები

v1.0.x · განახლდა 2026-07-05

ზოგიერთი ფუნქცია — საუბარი, ვიდეო, ვებ-ძებნა, უსათაურო ბრაუზერი — თავად გეითვეის ნაწილი არ არის. ისინი მუშაობენ როგორც ბავშვთა ვაზნები: მცირე დამოუკიდებელი HTTP-სერვისები, რომელთაც მიმართავს გეითვეი URL-ის მიხედვით. თითოეული ეტლი უფასო და ადგილობრივი: მათთვის სავალდებულო გადახდილი API არ არსებობს.

რა არის მოტოციკლის ეტლი

საიდკარი — ეს არის დამოუკიდებელი პროცესი, რომელიც უზრუნველყოფს HTTP API-ს. გეითი არასდროს ათავსებს მას ან არ ესვრის პროცესში — ის უბრალოდ იძახებს URL-ს, რომელიც თქვენ გაწყეთ. თითოეული საიდკარი

  • მუშაობს საკუთარ systemd unit-ში (ჰოსტზე, კონტეინერების გარეშე),
  • გაერთიანებულია ჭიშკართან გარემოს ცვლის მეშვეობით, და
  • შეიძლება გადმონტაჟებული ადგილობრივად გეიტვეის გვერდით ან აღინიშნული არსებული მიმართულებით მაგალითი თქვენ უკვე სხვაგან გარბიხართ.

ამიტომაც, როდესაც კონტრაქტი იყენებს მხოლოდ HTTP-ს, იგივე კონფიგურაცია მუშაობს, იყოს თუ არა საიდკარი ჩართული localhost ან სხვა მასპინძელზე.

[!NOTE] საიდკარები არასავალდებულოა — ერთი გამონაკლისით: ვებ-ძიება (SearXNG) და ანტიდეტექტ-ბრაუზერი (CloakBrowser) ყუთიდანვე დაყენებულია. მათი პაკეტები შედის ხელმოწერილ საინსტალაციო ბანდლში და ინსტალირდება ოფლაინ. მათი გამორთვა შესაძლებელია ინსტალატორის დროშებით --no-search და --no-browser. ყველა სხვა ფუნქცია აქტიურია მხოლოდ მაშინ, როცა მისი URL კონფიგურირებულია; მინიმალური ინსტალაცია კვლავ მხოლოდ გეიტვეი პლუს PostgreSQL-ია.

სეიდკარები და მათი პორტები

პორტი საიქარი მხარდაჭერილი ძალა გაერთიანებული
8001 STT სწრაფად-ჩურჩული მოლაპარაკება ტექსტში AIHUMMER_STT_URL
8002 ტექსტიდან წაკითხვა edge-tts ტექსტი-მოვლენაში AIHUMMER_TTS_URL
8005 ვიდეო ფფმეპგ ვიდეოს გაგება AIHUMMER_VIDEO_URL
8888 SearXNG SearXNG ეს web_search ინსტრუმენტი აყენებს ინსტალატორი, პარამეტრი დამალულია; გარე ინსტანსი — --external-search=URL
9222 კრომი / CDP ქრომი (CDP) ეს browser ინსტრუმენტი აყენებს ინსტალატორი, პარამეტრი დამალულია; გარე ინსტანსი — --external-browser=URL

ხმის საუდადო გვერდითი გზები — ეს მზად გზა არის: STT (:8001) აგენტს გადასცემს გამორთვას და TTS (:8002) პასუხობს როგორც უფასო, ასევე ადგილობრივ ძრავებზე. ვიდეოს გაგება (:8005) არის დამატებითი, მოთხოვნით დაკავშირებადი საიდკარი. SearXNG (:8888) ზურგი web_search, და საბოლოო წერტილი Chrome/CDP (:9222) მხარს უჭერს browser ობიექტი.

საიდკარის დაკავშირება

თქვენ მიმართავთ გეიტს თითოეულ საიდკარს შესაბამისთან კატალოგის კონფიგურაცია — ადმინისტრაციული ინტერფეისიდან (მართვა → პარამეტრები) ან ს aihummer settings set. gateway.env მომხმარებელია მხოლოდ bootstrap-ისთვის და უგულებელყოფილია ამ საკვანძო სიტყვებისთვის. მასპინძელზე ხმოვან გვერდის კომპონენტებს (STT/TTS) თქვენთვის ამზადებენ; ვებ-ძიებას და ბრაუზერს თავად ინსტალატორი აერთებს — მათ მისამართებს არასოდეს აყენებთ და ისინი პარამეტრებში არ ჩანს; დანარჩენს თქვენ ჩართავთ საჭიროების მიხედვით.

# Voice in/out (auto-configured by the installer for STT/TTS)
aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings set AIHUMMER_TTS_URL http://127.0.0.1:8002

# Optional video sidecar
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005

[!TIP] რადგან ყველა საიდკარი უბრალოდ URL-ია, შეგიძლიათ ცენტრალიზება გაუკეთოთ მძიმე სერვისებს: მიმართეთ რამდენიმე გეიტვეი ერთ საერთო STT/TTS ინსტანსზე, ნაცვლად იმისა, რომ თითო ჰოსტზე ცალკე ასლი გაუშვათ; ძიებისა და ბრაუზერისთვის იმავეს აკეთებენ ინსტალატორის დროშები --external-search=URL და --external-browser=URL.

მოვმართოთ ისინი ნატიურად ან ერთად

ყოველი საიდკარი მუშაობს თავის საკუთარ systemd სისტემაზე ჰოსტზე, ამიტომ მას მართავთ როგორც ნებისმიერ სხვა სერვისს — ვიწყებთ, ვჩუმავთ და ვუყურებთ ჟურნალს შესასვლელი წარსულისგან დამოუკიდებლად. თუ თქვენ უკვე მართავთ, მაგალითად, SearXNG-ს ან Chrome/CDP-ის ბოლო წერტილს, გადაეცით ინსტალატორს --external-search=URL ან --external-browser=URL: ლოკალური ასლი არ დაყენდება და გეიტვეი თქვენს ინსტანსს გამოიძახებს. ხმისა და ვიდეოსთვის მიუთითეთ შესაბამისი პარამეტრი არსებულ ინსტანსზე. ნებისმიერ შემთხვევაში, გარდამტეხის ხილვა იდენტურია: დაყენებული URL, რომელსაც ის შეუძლია გამოძახება.

[!WARNING] ეს browser (CDP) და web_search ინსტრუმენტები უკავშირდება ქსელს. ჩართულია მონაცემების გამომავალის და იზოლირებული გარემოს კონფიგურაციის მიმოხილვა დაცული ან იზოლირებული განლაგებისთვის სანამ მათ ჩართავთ — გადამრთველი იწვევს მხოლოდ გვერდით კონტეინერს, რომლოსაც დაუკავშირდით.

სად შემდეგ?