Mnie

Self-host finance management for running your own portfolio, trading, API key, OAuth, MCP, and CLI workflows.

Mnie SDK

@repo/mnie-sdk connects to a Mnie server with an API key and exposes typed finance methods from @repo/mnie-types.

Apps

• apps/mnie-app: bundled server plus UI runtime
• apps/mnie-server: API, OAuth, MCP, RPC, storage, and provider session management
• apps/mnie-ui: web UI

Packages

• packages/mnie-types: shared finance SDK interfaces
• packages/mnie-sdk: API-key SDK for Mnie
• packages/mnie-cli: CLI using mnie-sdk
• packages/client-sbi: SBI provider client

Install

Before running, setup .env, refering .env.example.

With docker

Docker uses MNIE_KEYRING_BACKEND=sqlite because platform keyrings are not available in headless containers. Set MNIE_KEYRING_SECRET in .env before saving SBI passkeys.

docker-compose.yml:

services:
  mnie:
    image: git.yutakobayashi.com/nakasyou/mnie:latest
    ports:
      - '18787:8787'
    env_file:
      - .env
    volumes:
      - ./data:/app/data

or

docker run --rm -it --name mnie \
  -p 18787:8787 \
  --env-file .env \
  -v "$PWD/data:/app/data" \
  git.yutakobayashi.com/nakasyou/mnie:latest

With Nix

nix run 'git+https://git.yutakobayashi.com/nakasyou/mnie.git#mnie'