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.

1.3 KiB

아리(Ari) — AI Life OS

일·삶을 한곳에서 관리하는 한국어 AI 개인비서 아리의 MVP. 핵심 철학: "적을 때는 분류하지 않는다 — 분류·배치·자동화는 아리가."

모노레포: frontend/(Next.js App Router + TS) · backend/(FastAPI + SQLite + Ollama). 개발 문서는 dev/(진입: dev/overview.md), 디자인 기준은 design-reference/.

빠른 시작 (Phase 0)

# 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/  원본 프로토타입 (픽셀 충실 재현 기준)