gnexus-creds
=============

Personal secret storage service with REST API, MCP HTTP/SSE adapter, and Vue UI.

## Backend

Install dependencies:

```bash
uv sync --extra dev
```

Run migrations:

```bash
uv run alembic upgrade head
```

Start API:

```bash
uv run uvicorn gnexus_creds.main:app --reload
```

Health endpoints:

```text
GET /health
GET /ready
```

## Frontend

The frontend lives in `frontend/` and uses Vue 3 plus `gnexus-ui-kit` as a git
dependency.

```bash
cd frontend
npm install
npm run dev
```

Note: `gnexus-ui-kit` must publish or prepare its `dist/` artifacts for git
dependency consumers. If `dist/` is missing from the installed package, the UI
build cannot resolve `gnexus-ui-kit/vue` or the kit CSS.

## Tests

```bash
uv run pytest
uv run ruff check .
```

## Demo Data

After applying migrations against a configured PostgreSQL database:

```bash
uv run python scripts/seed_demo.py
```

## Docker

```bash
docker build -t gnexus-creds .
docker run --env-file .env -p 8000:8000 gnexus-creds
```