---
title: "Жылдам бастау"
description: "Нөлден бастап бес минутта алғашқы жазбаға дейін: данаңызды бір контейнермен көтеріп, алғашқы жазбаңызды жасаңыз және ЖИ-агентті қосыңыз."
---

# Жылдам бастау

Notarium — бұл өз дискіңіздегі әдеттегі Markdown-файлдар түрінде құрылған, **адам мен ЖИ-агент** тең дәрежеде жұмыс істейтін өзіндік хостингтегі білім қоры. Ешқандай бұлт, ешқандай меншікті пішім жоқ: жазбалар қалталарда жатады, ал ақиқат көзі git бола алады.

Бұл бөлім — нөлден бастап жұмыс істеп тұрған данаға дейінгі ең қысқа жол: Notarium-ды бір контейнермен өрістетіңіз, веб-редакторда алғашқы жазбаңызды жасаңыз және агентіңізді MCP арқылы қосыңыз. Бүкіл жолға шамамен бес минут кетеді.

> [!note] Не қажет болады
> Тек **Docker** (немесе Docker Desktop) және бос порт. Қалғанының бәрі — веб-редактор, қозғалтқыш және агенттерге арналған MCP-эндпоинт — образдың ішінде дайын тұр. Node, дерекқор немесе векторлық индексті бөлек орнатудың қажеті жоқ.

## Бұл қалай құрылған

Бір білім қоры бір мезгілде екі оқырманға ашық. Адам веб-редактор арқылы, агент MCP-эндпоинт арқылы жұмыс істейді; екеуі де бір жазбалар графын көреді, ал дискіде бұл жай ғана `.md`-файлдар ағашы.

```mermaid
flowchart LR
  human([Адам]) -->|веб-редактор| core
  agent([ЖИ-агент]) -->|MCP · start_session| core
  core[Notarium қозғалтқышы] --> files[(Дискідегі<br/>Markdown-файлдар)]
  files -.->|git = ақиқат көзі| git[(Репозиторий)]
```

Негізгі қағида — **file-first**: жазба — бұл файл, біреудің бөтен дерекқорындағы жол емес. Экспорттың қажеті жоқ, өйткені сіз ешқашан «ішінде» болмайсыз — деректер әрқашан сіздікі әрі әрқашан дискіде.

## Дананы көтеру

Ең жылдам тәсіл — дайын образды іске қосу. Ол өзін-өзі қамтамасыз етеді: қозғалтқышты, веб-интерфейсті және MCP-эндпоинтті бірден көтереді.

```bash
# Образды алып, контейнерді көтеру
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest
```

Бір `/data` томы бүкіл күйді ұстайды: қызметтік дерекқорды, индекстерді, жазбаларыңызды және экспорт артефактілерін. Одан басқа баптайтын ешнәрсе жоқ — `3000` порты мен `/data` деректер жолы образда әлдеқашан белгіленген. `3000`-ден сол жақтағы портты кез келген бос портқа ауыстыруға болады.

`http://localhost:3000` мекенжайын ашыңыз — сізді **алғашқы іске қосудың орнату экраны** қарсы алады. Ол дананың иесін (алғашқы аккаунт) және бастапқы (жеке) кеңістікті құрады. Одан кейін сіз редактордасыз.

> [!tip] Порт пен деректер
> `3000` портын `-p <өзіңіздікі>:3000` дегендегі сол жақ бөлікпен ауыстыруға болады. `docouno/notarium` образы — ашық қолжетімді, бұл орнатудың негізгі жолы (толығырақ және бастапқы кодтан құрастыру — [Орнату](/docs/getting-started/installation/) бетінде). `/data` томы контейнерді қайта жасағанда сақталады — бірақ томның өзін сақтаңыз: онымен бірге деректер де жоғалады.

Алғашқы іске қосуда ішкі жағында не болады:

- қозғалтқыш көтеріліп, көрсетілген портта веб-интерфейсті береді;
- `/data` томының ішінде кеңістіктеріңіздің ағашы инициализацияланады;
- орнату экраны иені құрады — данаға осы аккаунт иелік етеді.

## Әрі қарай

Дана көтерілді — әрі қарай үш қысқа қадам. Әрқайсысы өз бетінде талданған:

| Қадам | Бет | Не аласыз |
|---|---|---|
| 1 | [Орнату және іске қосу](/docs/getting-started/installation/) | `docker` / `make up`, томдар мен орнату экранының талдауы |
| 2 | [Алғашқы жазба](/docs/getting-started/first-note/) | Файлдар ағашы, веб-редактор, `.md`-ға сақтау |
| 3 | [Агентті қосу](/docs/getting-started/connect-agent/) | Токен, `POST /mcp` эндпоинті, `start_session` шақыруы |

Алдымен модельді тұтастай түсінгіңіз келе ме — [Концепциялар](/docs/concepts/) бөліміне қараңыз: кеңістіктер мен жобалар, жазба түрлері, білім графы және адам мен агенттердің қатынау моделі.