Ыкчам баштоо

curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable

-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

http://localhost:8781/

Бул башталгыч колдонмо сизди биринчи AiHummer иштетүүңүз аркылуу алып өтөт — нөлдөн каналда жооп берип жаткан биринчи агентке чейин. Бул аны кимдир бирөө жасап жаткан адамга жазылган. **биринчи жолу**: ар бир кадам менен аяктайт **сен көрүшүң керек**, жана аягында «Эгер иштебей жатса» деген бөлүгү бар. ## Биринчи, жолуңузду тандаңыз AiHummer алуу үчүн эки жол бар (толук салыштыруу [Киришүү](/ky/v1.0/getting-started/introduction#cloud-or-your-own-server-which-to-pick)): - **Булут** — биз серверди иштетебиз, сиз даяр даректи аласыз. Орнотулчу эч нерсе жок. → баруу **[Баар жолу A: булут](#path-a-cloud)**. - **Өзүңүздүн хостингде (өзіңүздүн сервер)** — сиз Linux сервериңизге AiHummerди орното аласыз бир буйрук менен. → барыңыз **[B жолу: өзүңүздүн сервериңиз](#path-b-your-own-server)**. Андан кийин эки жол тең жалпы кадамдарга биригет — [биринчи агент](#step-create-your-first-agent) жана [биринчи канал](#step-connect-your-first-channel). ## Баар жолу A: булут **Саңа эмне керек болоору:** электрондук почта дареги, телефон номери жана банктык карта (сыноо үчүн банк ₽1 алып, аны дароо кайтарып берет). 1. Катталуу [my.aihummer.ru](https://my.aihummer.ru): электрондук почтаңызды, телефонуңузду киргизиңиз жана сырсөз, эки макулдашууларды кабыл алыңыз. *Сиз көрөсүз* эсепти тастыктоо экран. 2. Каттоо эсебин ырастоо — чалуу менен (келген номердин акыркы санын киргизиңиз) же электрондук почтадагы код менен. *Сиз көрөсүз* каттоо автоматтык түрдө болгонун жана каттоого алуу устасы ачылды. Толугураак маалымат: [Каттоо жана кирүү](/ky/v1.0/portal/registration). 3. Устаттан **Булут** жолун, андан кийин **планды** (ай сайын/жыл сайын) тандаңыз. кирүү планы менен коштоого келет **10 күндүк акысыз сыноо**. Толугураак: [Пландары](/ky/v1.0/portal/plans). 4. Сиздин маалыматты толтуруңуз **төлөмдүн деталдары** (жеке адам же компания/жеке ишкер) — алар чек жана акт үчүн керек. 5. Тандоо **поддомен аталышы** (сиздин дарегиңиз болот `<name>.cloud.aihummer.ru`) жана **төлөө**. *Сиз көрөсүз* "Көмөгүңүздү даярдоо" статусун жана анын прогресстин көрсөтүлүшүн. Толугураак: [Буйрутма жана төлөм](/ky/v1.0/portal/order-payment). 6. Жабдуулар даяр болушун күтө туруңуз (адатта бир нече мүнөттө). Статус өзгөргөндө **Сенин ассистент иштеп жатат**, басыңыз **"Панелди ачуу"** — сиздин веб-администратордук интерфейс мисал ачылды. Толугураак маалымат: [Инстанциянын башкаруу панели](/ky/v1.0/portal/instance). Конфигурация веб-админ UIда улантылат — өзүңүздүн жерге кириңиз [биринчи агент](#step-create-your-first-agent). Булттагы инстанциянын админ паролу панелди биринчи жолу ачканда коюлат (өзүңүз хостингдегенде колдонулган өзүнчө пароль файлы бул жерде кереги жок). ## B жолу: өзүңүздүн сервериңиз **Саңа эмне керек болоору:** Linux сервери (x86_64 же arm64), `sudo` укуктар, жана PostgreSQL (же орнотуучу аны камсыз кылсын). Толук тизмеси: [Талаптар](/ky/v1.0/getting-started/requirements). ### 1-кадам. Жеке орнотуу шилтемеңизди алыңыз Жалпыга ачык орнотуу скрипти жок — шилтеме **жеке**. Катталуу [my.aihummer.ru](https://my.aihummer.ru), ач **Орнотуу** экранда жана «Менин жеке орнотуу шилтемемди алуу» дегенди чыкылдатыңыз. *Сиз көрөсүз* даяр буйрук жана көчүрүү баскычы менен. ### 2-кадам. Бир буйрук менен орнотуу Көчүрүлгөн команданы серверде иштетиңиз: ```bash curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh ``` Орноткучу архитектураны аныктайт, жүктөйт жана **кол коюлган топтомду текшерет**, орнотуу тамырын көрсөтөт `~/.aihummer` жана шлюз кызматын systemd ичинде каттайт. *Сиз көрөсүз* орнотуу баскычынын журналын жана аягында кызмат башталды деген билдирүүнү. Толук маалымат (чыгаруу каналдары, сайдкарлар, rootless орнотуу): [Орнотуу](/ky/v1.0/getting-started/installation). ### 3‑кадам. PostgreSQLке көрсөткүңүз Жалгыз катуу көз карандылык – PostgreSQL менен `pgcrypto` кеңейтүү. Орноткуучу сиз үчүн туташууну орнотуп берет; базаны кол менен орнотуу үчүн, колдонуңуз `AIHUMMER_DATABASE_URL` конфигурация параметри: ```ini AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable ``` ```sql -- once, in the target database CREATE EXTENSION IF NOT EXISTS pgcrypto; ``` Маалымат базасын көчүрүү стартап учурунда автоматтык түрдө колдонулат. ### Кадам 4. Биринчи кирүү Кызмат иштей баштаганда, сервердеги админ Web UI'ди ачыңыз (купита жеке порт) `:8781` адатта) ```text http://localhost:8781/ ``` Бош базага кирүү `admin` жаралат жана баштапкы пароль анын үстүнө жазылат `~/.aihummer/etc/initial-admin-password.txt`. Буга окуп чыгып, кол коюп, андан кийин **паролду өзгөртүп, файлды дароо өчүрүңүз** — кадам сайын ичиндеги [Биринчи кирүү](/ky/v1.0/getting-started/first-login). ## Кадам: биринчи агентиңизди түзүңүз Бул кадам булут жана өз алдынча орнотулган менен бөлүшүлөт. Веб админ UIда ачыңыз **"Агенттер"** → **"+ Жаратуу"**, ат коюп, инсанды (система буйругу) жана кааласаң, атайын моделди орнотуңуз. *Сиз* жаңы агентти тизмеде плитка катары көрөсүз. Толук маалымат, каарман жана жүрүм-турумду жөндөө менен: [Агенттер](/ky/v1.0/webui/agents). ## Кадам: биринчи канал менен туташтырыңыз AiHummerге билдирүүлөр жетиши үчүн, канал кошуңуз: - **Телеграм** — эң өндүрүшкө даяр туташтыруучу; башынан аягына чейин кадам-кадам көрсөтмө "BotFatherдан биринчи билдирүүгө чейин" турат [Телеграм](/ky/v1.0/channels/telegram). - **Веб UIдагы сессиялар** — агентти туташтырбастан мурун аны текшерүүнүн эң тез жолу сырткы канал. - **МАКС** — орус жооп берүүчү, ошондой эле жеткиликтүү. Туташтыргыч жерге орнотулат [Плагиндер/Маркетплейс](/ky/v1.0/webui/marketplace) экран, андан кийин түзүлгөн [Каналдар](/ky/v1.0/webui/channels) экран, кайда **"Байланыштар"** агент кайсы каналды иштетерин блоктор орнотот. Каналга билдирүү жөнөтүп, бир айлануунун башынан аягына чейин агып өтүшүн караңыз. ## Админ UI аркылуу түздөн-түз агент менен сүйлө Биринчи сыноо үчүн канал талап кылынбайт: үстүндө **"Сессиялар"** «Жаңы сессия» баскычы бетинде админ UI ичинде түздөн-түз агент менен баарлашуу ачылат. Композитордо сиз **файлдарды тиркөө** (сүрөттөр жана документтер — модель алынган текстти alат), жана жиптин үстүндө эки которгуч көрүнүп турат **ар бир айлампадагы чыгым** жана **куралдын жыйынтыгы** — ар бир кадамда агент эмне кылганын көрүүгө ыңгайлуу. > [!TIP] > Сиз ошондой эле AiHummerди түздөн-түз OpenAI менен шайкеш API аркылуу чакыра аласыз, эч кандай > каналдын баары: > > ```http > POST /v1/chat/completions > Content-Type: application/json > > {"model": "default", "messages": [{"role": "user", "content": "Hello"}]} > ``` > > Орнотуу `"stream": true` SSE агымына үчүн. ## Эскиз моделди эсиңизде сактаңыз Чындап моделге туташтырганга чейин, жооптор келет **детерминисттик макет** — каналдарды, багыттоону жана агенттерди модель чыгымсыз сыноо үчүн ыңгайлуу. Чыныгы провайдерге (OpenAI, Anthropic, YandexGPT, GigaChat, Codex ChatGPT жазылуу аркылуу жана башкалар) кантип туташтырса болору жөнүндө [Моделдер](/ky/v1.0/webui/models) барак. > [!NOTE] > Чыныгы модель эч качан *обязательный* эмес: AiHummer акысыз/жергиликтүү түрдө иштейт > OpenAIге шайкеш келген аяк процессорлору жана Codex/ChatGPT-жазылуу транспорту. ## Эгер ал иштебесе - **Орнотуу командасы ийгиликсиз болду** — анын Linux x86_64/arm64 системасында иштеп жатканын текшериңиз жана жеке шилтеме эскирбегенин текшериңиз (ал 30 күн жашайт; жаңысын алууга «Орнотуу» экраны). Диагностика: [Орнотуу](/ky/v1.0/getting-started/installation#verify-the-installation). - **Админ UI ачылбай жатат** — Веб интерфейс жеке портту угат `:8781`, жарандык эмес `:8780`. Кызматты текшерип көрүңүз: `systemctl status aihummer-gateway`. - **Баштапкы сырсөздү таба албай жатам** — ал ичинде `~/.aihummer/etc/initial-admin-password.txt`, журналдарда эмес. Караңыз [Биринчи кирүү](/ky/v1.0/getting-started/first-login#find-the-initial-password). - **Булут аркылуу төлөм ишке ашкан жок** — башкаруу панели боюнча жазылуу абалы көрсөтөт себеп; кайра аракет кылыңыз, же (компаниялар үчүн) эсеп боюнча төлөө тандаңыз, караңыз [Буйрутма жана төлөм](/ky/v1.0/portal/order-payment). - **Агент каналда жооп бербейт** — каналдын байланганына ынан «Тууташтыруулар» блогундагы агент жана жөнөтүүчүнүн система тарабынан белгилүү экендиги (аркылы) демейки боюнча агент жөн гана белгилүү колдонуучуларга жооп берет), караңыз [Каналдар](/ky/v1.0/webui/channels). ## Келерки кайда - Өнөр жай үчүн өзүнө жайгаштыруу: [Орнотуу](/ky/v1.0/getting-started/installation). - UI аркылуу жүрүм-турумду жөндөө: [Конфигурация](/ky/v1.0/getting-started/configuration). - Биринчи кирүүнү коопсуз кылуу: [Биринчи кирүү](/ky/v1.0/getting-started/first-login). - Моделди туташтырыңыз: [Моделдер](/ky/v1.0/webui/models).