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 en la rama
maincon base en Python 3.12, Flask y SQLAlchemy. - Arquitectura basada en blueprints por módulo:
auth,bancos,compras,ventas,inventario,contabilidad,document_flow,importsy más. - Soporte inicial de AR/AP, pagos/cobros, conciliación, inventario con valuación, impuestos y reglas fiscales, documentos operativos, importaciones masivas y trazabilidad documental.
- UI con Alpine.js,
smart-selecty diseño de formularios transaccionales compartidos. - Internacionalización preparada para
esyen. - Calidad integrada con
black,ruff,flake8,mypy,pydocstyleypytest.
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.
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 -v -s --exitfirst --slow=True
CLI - cacaoctl
cacaoctl es la interfaz de línea de comandos oficial para administrar Cacao Accounting.
# Inicializar la base de datos
cacaoctl db init
# 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
Para más detalles, consulta la documentación de cacaoctl.
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
Release files for cacao-accounting 0.0.1.dev20260720
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cacao_accounting-0.0.1.dev20260720.tar.gz | 6.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cacao_accounting-0.0.1.dev20260720-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.2 MB
Release files / cacao_accounting-0.0.1.dev20260720.tar.gz
| Download URL | cacao_accounting-0.0.1.dev20260720.tar.gz |
|---|---|
| Size | 6.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
393e167c22e686e054a7ec114a851fdb7fb50187065fc779b8df48df1a5caa1e
|
|
BLAKE2b-256 checksum How to use checksums |
429862b10eec456b8de106f4ae343f0732cf98eaa046c8486a31ae1d6142c392
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.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 Jul 21, 2026.
Transparency logRelease files / cacao_accounting-0.0.1.dev20260720-py3-none-any.whl
| Download URL | cacao_accounting-0.0.1.dev20260720-py3-none-any.whl |
|---|---|
| Size | 7.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0a8758669ca9e6ff2fcee88d6e045c96a847ea8cdf6ab26f283f96cb5d255879
|
|
BLAKE2b-256 checksum How to use checksums |
29911a7a9232e077f5a8b17a2e544a56eafb2eb804f3bca6549ff108213363d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.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 Jul 21, 2026.
Transparency log
