You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
41 lines
1.3 KiB
Markdown
41 lines
1.3 KiB
Markdown
# 아리(Ari) — AI Life OS
|
|
|
|
일·삶을 한곳에서 관리하는 한국어 AI 개인비서 **아리**의 MVP.
|
|
핵심 철학: **"적을 때는 분류하지 않는다 — 분류·배치·자동화는 아리가."**
|
|
|
|
모노레포: `frontend/`(Next.js App Router + TS) · `backend/`(FastAPI + SQLite + Ollama).
|
|
개발 문서는 `dev/`(진입: `dev/overview.md`), 디자인 기준은 `design-reference/`.
|
|
|
|
## 빠른 시작 (Phase 0)
|
|
|
|
```bash
|
|
# 0) 사전 설치: Node20+/pnpm, Python3.11+/uv, Ollama
|
|
make install # 프론트+백 의존성
|
|
|
|
# 1) 환경변수
|
|
cp backend/.env.example backend/.env # 필요 시 OLLAMA_MODEL 등 수정
|
|
echo 'NEXT_PUBLIC_API_BASE=http://localhost:8000' > frontend/.env.local
|
|
|
|
# 2) (선택) Ollama
|
|
ollama serve &
|
|
ollama pull <설치할_모델> # .env 의 OLLAMA_MODEL 과 맞춤 (특정 모델 강제 아님)
|
|
|
|
# 3) 실행
|
|
make dev # 프론트 :3000 + 백 :8000
|
|
|
|
# 4) 스모크
|
|
make health # /api/health, /api/llm/health
|
|
make test # pytest + vitest
|
|
make lint # ruff + eslint
|
|
```
|
|
|
|
## 구조
|
|
|
|
```
|
|
workspace/
|
|
├─ frontend/ Next.js (App Router, TypeScript)
|
|
├─ backend/ FastAPI (SQLite, SQLModel, Alembic, Ollama)
|
|
├─ dev/ 개발 문서 (overview.md + phase-*.md)
|
|
└─ design-reference/ 원본 프로토타입 (픽셀 충실 재현 기준)
|
|
```
|