esetheyers/caudal
1
Fork 0
Code Issues Pull requests Projects Releases 10 Wiki Activity
Tus inversiones y tu bitcoin, llevados en tu casa
2 commits 1 branch 10 tags 1.9 MiB
  • Python 71.4%
  • JavaScript 22.7%
  • CSS 2.6%
  • Shell 1.1%
  • TypeScript 1%
  • Other 1.2%
Find a file
Exact
esetheyers cf7cc9a8c7 Caudal 0.1.2 
Diseño para móvil, programa de escritorio para Linux (un solo fichero) y versiones firmadas: manifiesto de huellas, firma PGP y la clave del autor (VERIFICAR.md).
2026-10-14 16:42:53 -05:00
empaquetado Caudal 0.1.2 2026-10-14 16:42:53 -05:00
programa Caudal 0.1.2 2026-10-14 16:42:53 -05:00
.dockerignore Caudal 0.1.1 2026-10-13 08:01:06 -05:00
.gitignore Caudal 0.1.2 2026-10-14 16:42:53 -05:00
abrir_app.sh Caudal 0.1.1 2026-10-13 08:01:06 -05:00
actualizar_app.sh Caudal 0.1.1 2026-10-13 08:01:06 -05:00
AVISO.md Caudal 0.1.1 2026-10-13 08:01:06 -05:00
Dockerfile Caudal 0.1.2 2026-10-14 16:42:53 -05:00
esetheyers.asc Caudal 0.1.2 2026-10-14 16:42:53 -05:00
LICENSE Caudal 0.1.1 2026-10-13 08:01:06 -05:00
README.md Caudal 0.1.2 2026-10-14 16:42:53 -05:00
VERIFICAR.md Caudal 0.1.2 2026-10-14 16:42:53 -05:00

README.md

Caudal

Tus inversiones y tu bitcoin, llevados en tu casa.

Caudal reúne en un solo sitio fondos, acciones, planes de pensiones, cuentas y, sobre todo, bitcoin leído desde tu propio nodo solo con la clave pública de tus monederos. Te dice cuánto vale todo y cuánto has ganado de verdad, y prepara lo que hay que declarar en España (FIFO, minería como actividad económica, territorio común y Navarra).

  • Tus datos no salen de tu casa. No hay cuenta, ni nube, ni telemetría.
  • Nunca pide claves privadas. Para bitcoin basta la clave pública o direcciones sueltas.
  • Cifrado opcional con una sola contraseña y una clave de recuperación.

Dónde funciona

  • StartOS (Start9): el paquete se construye desde empaquetado/startos/ y se instala con «Sideload». Cómo, en empaquetado/LEEME.md.
  • Umbrel: desde la tienda de aplicaciones del autor, https://codeberg.org/esetheyers/umbrel-apps (en preparación).
  • Docker: docker build -t caudal . && docker run -d -p 8080:8080 -v caudal-datos:/data caudal.
  • Tu ordenador o un USB: Python 3.10 o posterior y bash abrir_app.sh. Los detalles, en programa/LEEME.md.

En un servidor se entra con una contraseña que se crea la primera vez. En tu ordenador solo atiende en el propio equipo.

Comprobar lo que descargas

Cada versión va con un manifiesto de huellas firmado con PGP. Cómo comprobarlo, con Sparrow o con dos órdenes, en VERIFICAR.md.

La clave del autor es esetheyers.asc (esetheyers <esetheyers@huveme.com>), con esta huella:

3648 41BA B31F 9D0F 3D07  5629 C34F 1F5D 7116 CA10

Qué sale a internet

Solo los precios: Caudal pregunta a fuentes públicas (Morningstar, Yahoo, CoinGecko, LS Exchange y un cambio de divisa) por los identificadores de lo que tienes, nunca por las cantidades. Bitcoin lo lee de tu servidor Electrum, por Tor si su dirección es .onion. Funciona sin conexión; lo único que deja de moverse son los precios.

Pruebas

cd programa && python3 -m unittest discover -s pruebas

Se pasan enteras sin internet, con una cartera ficticia.

Fallos, ideas y mejoras

Abre una incidencia en este repositorio. Para enseñar un fallo usa la cartera de ejemplo que trae la aplicación: no publiques tus datos ni capturas con tus cifras.

Las propuestas de código son bienvenidas; antes de una grande, abre una incidencia para comentarla. Las condiciones están en AVISO.md.

Licencia

AGPL-3.0 o posterior (LICENSE). Sin ninguna garantía: la parte fiscal es una ayuda para preparar tu declaración, no asesoría fiscal.

Hecho por esetheyers con Claude (Anthropic).