This release is a pre-release and may not be stable for production use.
Cacao Accounting
Aplicación contable web y de escritorio para PYMEs que centraliza tesorería, compras, ventas, inventario y contabilidad general.
Estado actual
- En desarrollo activo sobre Python 3.12+, Flask, SQLAlchemy y Alpine.js.
- Arquitectura basada en blueprints por módulo, con servicios y repositorios para la lógica de negocio y el acceso a datos.
- El núcleo contable usa
GLEntrycomo fuente única de verdad, soporta múltiples libros, multimoneda, reversas y cierre de períodos. - Están integrados los flujos de compras (S2P), ventas (O2C), bancos, inventario, impuestos, AR/AP, importaciones masivas y trazabilidad documental.
- La interfaz usa formularios transaccionales compartidos,
smart-select, reportes financieros/operativos y acciones derivadas administradas pordocument_flow. - La CLI oficial
cacaoctladministra base de datos, servidor, diagnóstico y desarrollo. - El proyecto sigue en desarrollo y no está listo para uso en producción.
Nota: el proyecto sigue siendo de desarrollo y no está listo para uso en producción.
Características principales implementadas
- Cuentas por cobrar y cuentas por pagar.
- Gestión de inventario con
Stock Reconciliationy valuación de ajustes. - Payment entry con impuestos y cargos visibles, reglas fiscales y aplicación de referencias.
- Matriz de flujo documental (
document_flow) para crear documentos derivados y mantener trazabilidad. - Administración de clientes/proveedores con contactos, direcciones, grupos y cuentas por compañía.
- Motor fiscal unificado para preview y persistencia de reglas fiscales.
- Proceso de importación masiva de datos y documentos operativos.
- Revalorización cambiaria auditada y soporte para múltiples libros/ledgers.
- Cancelaciones y reversas append-only, con reportes que excluyen los movimientos anulados por defecto.
- Docker con Caddy como proxy, Waitress como servidor WSGI y migraciones Alembic idempotentes.
Uso recomendado para desarrolladores
- Crear un entorno virtual:
python -m venv .venv - Activar el entorno:
source .venv/bin/activate - Instalar dependencias:
pip install -r requirements.txt - Para habilitar características en la nube (como validación MIME segura en la subida de archivos), instale las dependencias opcionales:
pip install cacao-accounting[cloud] - Ejecutar pruebas:
CACAO_TEST=True LOGURU_LEVEL=WARNING SECRET_KEY=ASD123kljaAddS python -m pytest --tb=line --quiet --disable-warnings --slow=True
CLI - cacaoctl
cacaoctl es la interfaz de línea de comandos oficial para administrar Cacao Accounting.
# Crear la base de datos (idempotente)
cacaoctl db init
# Aplicar migraciones pendientes (idempotente)
cacaoctl db migrate
# Crear la base de datos con datos de ejemplo
cacaoctl db init --seed
# Recrear la base de datos; solicita confirmación si no se usa --force
cacaoctl db reset
# Eliminar la base de datos solo en desarrollo
cacaoctl db clean
# Iniciar servidor de desarrollo
cacaoctl run
# Iniciar servidor de producción (Waitress)
cacaoctl serve
# Ver estado del sistema
cacaoctl status
# Ver configuración activa
cacaoctl config
# Consola interactiva con contexto de la aplicación
cacaoctl shell
# Listar rutas registradas
cacaoctl routes
Las opciones globales --env dev|test|prod, --verbose y --quiet deben
colocarse antes del comando, por ejemplo cacaoctl --env test db init --seed.
db reset y db clean son operaciones destructivas; --force omite la
confirmación. Para el detalle completo, consulta la documentación de cacaoctl.
Arranque local rápido
El script scripts/run_server.sh está destinado
únicamente al desarrollo local: conserva la base de datos existente, carga
datos de ejemplo solo al crearla y ejecuta cacaoctl run en 127.0.0.1:8080.
Para reiniciar la base de datos explícitamente, ejecútalo con
scripts/run_server.sh --clean. Se pueden
personalizar CACAO_HOST, CACAO_PORT, CACAO_USER, CACAO_PSWD,
CACAO_DATABASE_URL y SECRET_KEY mediante variables de entorno. Por
defecto utiliza cacaoaccounting.db en la raíz del proyecto, incluso en modo
de pruebas, para que la inicialización sobreviva entre procesos.
Para un servidor WSGI usa cacaoctl serve. En Docker, el entrypoint ejecuta
cacaoctl db init y cacaoctl db migrate de forma idempotente antes de
arrancar la aplicación.
Demo online
Live demo at:
URL: https://cacao-accounting.onrender.com/login
User: cacao
Password: cacao
Wait to the free render instance to wake up.
Participar en el proyecto
Todos los aportes son bienvenidos. Consulta el archivo CONTRIBUTING para más detalles.
Licencia
Derechos de autor 2024 - 2026 William José Moreno Reyes
Autorizado en virtud de la Licencia de Apache, Versión 2.0 (la "Licencia"); se prohíbe utilizar este archivo excepto en cumplimiento de la Licencia. Podrá obtener una copia de la Licencia en:
http://www.apache.org/licenses/LICENSE-2.0
A menos que lo exijan las leyes pertinentes o se haya establecido por escrito, el software distribuido en virtud de la Licencia se distribuye “TAL CUAL”, SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ya sean expresas o implícitas. Véase la Licencia para consultar el texto específico relativo a los permisos y limitaciones establecidos en la Licencia.
2 maintainers
Metadata
2 maintainers
Release files for cacao-accounting 0.0.1.dev20261005
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| cacao_accounting-0.0.1.dev20261005.tar.gz | 5.6 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cacao_accounting-0.0.1.dev20261005-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.4 MB
Release files / cacao_accounting-0.0.1.dev20261005.tar.gz
| Download URL | cacao_accounting-0.0.1.dev20261005.tar.gz |
|---|---|
| Size | 5.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
712d5a3d5ab255606b4c8c51e1e83a7040dfbe5356c83c7598f334002f5389a4
|
|
BLAKE2b-256 checksum How to use checksums |
17e6a9c135d5d6a095a58b9c5f5f642591c77a5bc4c539c883b5ea562304c6dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / cacao_accounting-0.0.1.dev20261005-py3-none-any.whl
| Download URL | cacao_accounting-0.0.1.dev20261005-py3-none-any.whl |
|---|---|
| Size | 6.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
23b9e37188bfbd149b2baa636beb4ede3e1793bce3fe5fa3d271c66761074c87
|
|
BLAKE2b-256 checksum How to use checksums |
0c463df8ce374d6af222249a4cbf6ada0a27dc0aaa26ab0d5054f07be21d02ec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logSecurity for cacao-accounting 0.0.1.dev20261005
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for cacao_accounting-0.0.1.dev20261005.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
