Instalación
Requisitos
Cómo empezar
Descarga la versión estable del proyecto por aquí, y ubícala en una carpeta conveniente.
Ó revisa los lanzamientos mas recientes.
Ultima versión disponible
De esta manera te aseguras de que obtienes la versión más reciente, ahora, si lo que quieres es contribuir al proyecto, revisa el apartado de Como Contribuir.
Listado de Cambios
El listado completo de cambios (changelog), por aquí.
Instala uv
Nota
uv proporciona un reemplazo directo para los comandos comunes: pip, pip-tools y virtualenv.
uv amplía con características avanzadas, la gestión de entornos, de dependencias, de versiones de Python, de proyectos, manejo de scripts y más. Te permite declarar las bibliotecas de las que depende tu proyecto y las gestionará (instalará/actualizará) por tí.
más info sobre la instalación y uso de uv, por aquí.
una vez uv se encuentre instalado...
Instala Just y mejora el entorno de trabajo
Just es una forma práctica de guardar y ejecutar comandos específicos para tenerlos a la mano y gestionar tu proyecto, Just tiene un montón de características útiles.
más info sobre la instalación y uso de Just, por aquí.
Nota
Todas las tareas para Callisto, se encuentran en el archivo justfile ubicado en la raíz del proyecto.
una vez just se encuentre instalado...
Crea el entorno de trabajo
Importante
Es importante aclarar que Callisto hace uso de características presentes en Python 3.12.x ó superior, por lo que no se recomienda utilizar una versión anterior del lenguaje.
Instalar las dependencias
Nota
No es necesario "entrar" al entorno, ya que uv se encarga de esto, forma transparente.
ó instalar todas las dependencias por grupos:
Grupos de dependencias
Consulta el archivo pyproject.toml para más información de los nombres de grupos utilizados.
uv se rige al PEP 518 y PEP 621 al utilizar el archivo pyproject.toml, lo que proporciona una manera de organizar sus dependencias por grupos. Por ejemplo, usted podría tener dependencias que sólo son necesarios para probar su proyecto ó para construir la documentación.
Esta forma de instalar dependencias se detalla por aquí.
Iniciando el servidor local
La dirección y el puerto por defecto es: http://localhost:6969
Variables de entorno
Si se está usando MongoDB ó PostgreSQL como base de datos, es posible hacer uso de un archivo .env, ubicado en la raiz del proyecto (opción recomendada) y fijar las variables de entorno que se necesiten.
Nota
Recomendamos leer el apartado de Configuracion del entorno, para más información.