How do I install the Konto Deploy skill?

Run npx skillmds@latest add diegosouzapw/konto-deploy in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Konto Deploy safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Konto Deploy?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Konto Deploy free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Konto Deploy?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Konto Deploy by diegosouzapw — Agent Skill

Name: Konto Deploy
Rating: 4.5 (4 reviews)
Author: diegosouzapw

File contents

Konto — Local Deployment

Personal & professional finance dashboard. Bank sync, crypto, investments, budget, tax tools.

Prerequisites

Node.js 18+ and npm 9+
openssl (for encryption key generation)

Installation (3 commands)

git clone https://github.com/angelstreet/konto.git
cd konto
npm install

Configuration

# Create env from template
cp .env.example backend/.env

# Generate and set encryption key
KEY=$(openssl rand -hex 32)
sed -i "s/^DB_ENCRYPTION_KEY=$/DB_ENCRYPTION_KEY=$KEY/" backend/.env

Minimal config (works immediately)

Only DB_ENCRYPTION_KEY is required. Everything else is optional.

Optional integrations

Feature	Env vars	Sign up
Bank sync	`POWENS_CLIENT_ID`, `POWENS_CLIENT_SECRET`, `POWENS_DOMAIN`	powens.com
Production auth	`CLERK_SECRET_KEY`, `VITE_CLERK_PUBLISHABLE_KEY`	clerk.com
Coinbase	`COINBASE_CLIENT_ID`, `COINBASE_CLIENT_SECRET`	developers.coinbase.com
Google Drive	`GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`	console.cloud.google.com

Running

# Start both frontend + backend
npm run dev

Frontend: http://localhost:3004/konto/
Backend API: http://localhost:5004/api/
Login: user / user (local dev, no Clerk needed)

Sandbox / Demo Mode

Konto auto-seeds demo data for the default user:

Bank accounts (checking, savings, investment)
Crypto wallets (BTC, ETH, XRP)
Investment positions (PEA, Assurance Vie, PER)
14 months of transaction history
Real estate and vehicle assets

Just log in and explore — no external API keys needed.

Building for Production

npm run build
# Frontend: serve frontend/dist/ as static files
# Backend: node backend/dist/index.js

Vercel deployment

cd frontend && vercel
cd backend && vercel

Ports

Service	Port	URL
Frontend (dev)	3004	http://localhost:3004/konto/
Backend API	5004	http://localhost:5004/api/

Troubleshooting

Problem	Solution
`ENCRYPTION_KEY` error	Run `openssl rand -hex 32` and set in `backend/.env`
Port 3004 in use	`lsof -i :3004` to find process, kill or change `VITE_DEV_PORT`
Port 5004 in use	Change `PORT` in `backend/.env`
Clerk errors locally	Leave `CLERK_SECRET_KEY` empty — local dev bypasses Clerk
Empty dashboard	Log in as `user/user` — demo data seeds on first backend start
Bank sync not working	Requires Powens API keys (optional for demo)

Tech Stack

Layer	Tech
Frontend	React 18 + TypeScript + Vite + Tailwind CSS + Recharts
Backend	Hono + TypeScript + Node.js
Database	SQLite (local) or Turso (cloud)
Auth	Clerk (optional)

API Endpoints (key ones)

Endpoint	Description
`GET /api/bank/accounts`	Bank accounts
`GET /api/investments`	Investment positions
`GET /api/transactions`	Transaction history
`GET /api/companies`	Companies (pro)
`GET /api/patrimoine/summary`	Net worth summary
`GET /api/preferences`	User preferences

Full API docs: docs/API.md in the repo.

---name: konto-deploydescription: Deploy and run Konto (personal finance dashboard) locally. Use when setting up a new Konto instance, troubleshooting installation, or helping users get started with Konto.---# Konto — Local DeploymentPersonal & professional finance dashboard. Bank sync, crypto, investments, budget, tax tools.## Prerequisites- Node.js 18+ and npm 9+- `openssl` (for encryption key generation)## Installation (3 commands)```bashgit clone https://github.com/angelstreet/konto.gitcd kontonpm install```## Configuration```bash# Create env from templatecp .env.example backend/.env# Generate and set encryption keyKEY=$(openssl rand -hex 32)sed -i "s/^DB_ENCRYPTION_KEY=$/DB_ENCRYPTION_KEY=$KEY/" backend/.env```### Minimal config (works immediately)Only `DB_ENCRYPTION_KEY` is required. Everything else is optional.### Optional integrations| Feature | Env vars | Sign up ||---------|----------|---------|| Bank sync | `POWENS_CLIENT_ID`, `POWENS_CLIENT_SECRET`, `POWENS_DOMAIN` | [powens.com](https://powens.com) || Production auth | `CLERK_SECRET_KEY`, `VITE_CLERK_PUBLISHABLE_KEY` | [clerk.com](https://clerk.com) || Coinbase | `COINBASE_CLIENT_ID`, `COINBASE_CLIENT_SECRET` | [developers.coinbase.com](https://developers.coinbase.com) || Google Drive | `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET` | [console.cloud.google.com](https://console.cloud.google.com) |## Running```bash# Start both frontend + backendnpm run dev```- Frontend: http://localhost:3004/konto/- Backend API: http://localhost:5004/api/- Login: `user` / `user` (local dev, no Clerk needed)## Sandbox / Demo ModeKonto auto-seeds demo data for the default user:- Bank accounts (checking, savings, investment)- Crypto wallets (BTC, ETH, XRP)- Investment positions (PEA, Assurance Vie, PER)- 14 months of transaction history- Real estate and vehicle assetsJust log in and explore — no external API keys needed.## Building for Production```bashnpm run build# Frontend: serve frontend/dist/ as static files# Backend: node backend/dist/index.js```### Vercel deployment```bashcd frontend && vercelcd backend && vercel```## Ports| Service | Port | URL ||---------|------|-----|| Frontend (dev) | 3004 | http://localhost:3004/konto/ || Backend API | 5004 | http://localhost:5004/api/ |## Troubleshooting| Problem | Solution ||---------|----------|| `ENCRYPTION_KEY` error | Run `openssl rand -hex 32` and set in `backend/.env` || Port 3004 in use | `lsof -i :3004` to find process, kill or change `VITE_DEV_PORT` || Port 5004 in use | Change `PORT` in `backend/.env` || Clerk errors locally | Leave `CLERK_SECRET_KEY` empty — local dev bypasses Clerk || Empty dashboard | Log in as `user/user` — demo data seeds on first backend start || Bank sync not working | Requires Powens API keys (optional for demo) |## Tech Stack| Layer | Tech ||-------|------|| Frontend | React 18 + TypeScript + Vite + Tailwind CSS + Recharts || Backend | Hono + TypeScript + Node.js || Database | SQLite (local) or Turso (cloud) || Auth | Clerk (optional) |## API Endpoints (key ones)| Endpoint | Description ||----------|-------------|| `GET /api/bank/accounts` | Bank accounts || `GET /api/investments` | Investment positions || `GET /api/transactions` | Transaction history || `GET /api/companies` | Companies (pro) || `GET /api/patrimoine/summary` | Net worth summary || `GET /api/preferences` | User preferences |Full API docs: `docs/API.md` in the repo.

Frequently asked questions

Konto Deploy