# AGENTS.md — Cold Start

> Project: `Ollama/`
> Sesi: [docs/ai-session-summary.md](./docs/ai-session-summary.md)
> Peta: [docs/context-index.md](./docs/context-index.md)
> Env: [.env.example](./.env.example)

## Apa ini?

VM inference AI on-premise (Ollama) di `10.100.1.26` (`aiopr`) — chat `qwen2.5:7b` + embedding `nomic-embed-text` untuk geonet-console / project search. **Tidak** di-expose ke internet.

## Aturan kritis

- **No hardcoded URL/IP** — consumer pakai `OLLAMA_BASE_URL` di `.env` (lihat `.env.example`)
- Port `11434` hanya VLAN `10.100.1.0/24` (UFW); jangan buka ke publik
- **Jangan** jalankan Ollama di `10.100.1.24` (resource penuh)
- No commit `.env` / secret NAS DB
- No commit kecuali user minta
- **Deploy / perubahan material:** append [docs/version.md](./docs/version.md)
- SSH ke VM wajib persetujuan user (`ssh ollama` / `root@10.100.1.26`)
- Pengetahuan penting **wajib ke docs**

## Lanjut kerja

```
1. AGENTS.md → docs/ai-session-summary.md → STOP
2. docs/todo.md, docs/server.md, docs/api/overview.md
```

## Pointer

| Butuh | Buka |
|-------|------|
| Priority | [docs/todo.md](./docs/todo.md) |
| Versi / audit | [docs/version.md](./docs/version.md) |
| API Ollama | [docs/api/overview.md](./docs/api/overview.md) |
| Consumer app | `server-connection/geonet-console/config/ollama.php` |
| Requirement project search | `server-connection/server/ollama-nas-project-search-requirements.md` |
| Migrasi VM | [docs/guide/migration.md](./docs/guide/migration.md) |