Saltar a contenido

Instalación

Esta guía explica cómo instalar FastAPI-fastkit.

Requisitos

Para usar FastAPI-fastkit, necesitas cumplir los siguientes requisitos:

  • Python: 3.12 o superior
  • Sistema operativo: Windows, macOS y Linux soportados

Métodos de instalación

Instalar con pip (recomendado)

El método de instalación más simple:

$ pip install FastAPI-fastkit
---> 100%
Successfully installed FastAPI-fastkit

Instalar una versión específica

Para instalar una versión concreta:

$ pip install FastAPI-fastkit==1.0.0
---> 100%
Successfully installed FastAPI-fastkit-1.0.0

Instalar la versión de desarrollo

Para instalar la última versión de desarrollo directamente desde GitHub:

$ pip install git+https://github.com/bnbong/FastAPI-fastkit.git
---> 100%
Successfully installed FastAPI-fastkit

Aviso sobre la versión de desarrollo

Las versiones de desarrollo pueden ser inestables y no se recomiendan para entornos de producción.

Configurar un entorno virtual (recomendado)

Se recomienda encarecidamente usar un entorno virtual para evitar conflictos de dependencias:

Usando venv

$ python -m venv fastapi-env
$ source fastapi-env/bin/activate  # Linux/macOS
$ fastapi-env\Scripts\activate     # Windows
$ pip install FastAPI-fastkit

Usando conda

$ conda create -n fastapi-env python=3.12
$ conda activate fastapi-env
$ pip install FastAPI-fastkit

Verificar la instalación

Tras la instalación, comprueba que FastAPI-fastkit está correctamente instalado:

$ fastkit --version
FastAPI-fastkit version 1.0.0

$ fastkit --help
Usage: fastkit [OPTIONS] COMMAND [ARGS]...

  FastAPI-fastkit CLI

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  addroute       Add a new route to FastAPI project
  init           Create a new FastAPI project
  list-templates List available FastAPI templates
  runserver      Start FastAPI development server
  startdemo      Create FastAPI project from template

Solución de problemas

Comando no encontrado

Si obtienes un error "command not found":

  1. Comprueba si FastAPI-fastkit está instalado:
$ pip show FastAPI-fastkit
  1. Comprueba tu entorno virtual:
$ which python
$ which pip
  1. Reinstala FastAPI-fastkit:
$ pip uninstall FastAPI-fastkit
$ pip install FastAPI-fastkit

Errores de permisos

Si encuentras errores de permisos durante la instalación:

En Linux/macOS:

$ pip install --user FastAPI-fastkit

En Windows (ejecutar como administrador):

$ pip install FastAPI-fastkit

Compatibilidad de versión de Python

FastAPI-fastkit requiere Python 3.12+. Comprueba tu versión de Python:

$ python --version
Python 3.12.0

Si tienes una versión más antigua, actualiza Python:

  • Python oficial: python.org/downloads
  • Con pyenv: pyenv install 3.12.0
  • Con conda: conda install python=3.12

Próximos pasos

Una vez completada la instalación:

  1. Inicio rápido: Crea tu primer proyecto en 5 minutos
  2. Tutorial inicial: Tutorial paso a paso detallado
  3. Referencia de la CLI: Referencia completa de comandos

Consejos de instalación

  • Usa siempre entornos virtuales para aislar los proyectos
  • Mantén FastAPI-fastkit actualizado a la última versión
  • Revisa el repositorio de GitHub para actualizaciones e incidencias