Skip to content

⚡️ Prerequisites

Before installing HESTIA, ensure you have the following dependencies installed:

  • Python 3.10+
  • uv or pip Python Package Manager
  • Git
  • Docker & Docker Compose
  • Elasticsearch (Optional, for centralized logging)
  • Kibana (Optional, for log visualization)
  • Grafana (Optional, for advanced monitoring)

🐍 Python 3.10+

Ensure you have Python 3.10+ installed. If not, download and install it from the official Python website. Check your version:

python --version
For installation guides and troubleshooting, refer to the RealPython documentation.

📦 Package managers

Why We Recommend uv Over pip

While pip is the standard Python package manager, we strongly recommend using uv for managing dependencies and projects.

  • Lightning-fast Dependency Management – uv resolves, installs, and locks dependencies extremely quickly, even for large projects.
  • Built-in Virtual Environments & Python Management – uv automatically creates and manages isolated environments and can install/manage Python versions for you.
  • Reproducible Installs – uv uses pyproject.toml and uv.lock to ensure consistent, repeatable environments across machines.
  • Unified Workflow – uv consolidates the functionality of tools like uv, pip, pip-tools, pipx, virtualenv, poetry, pyenv, and twine into a single tool.

For long-term projects and production environments, uv provides a robust, scalable, and fast solution compared to plain pip.

Install uv as package and dependency manager:

curl -LsSf https://astral.sh/uv/install.sh | sh

Check if uv is installed correctly:

uv --version

Knowledge

If you don't have prior experience with Python, we recommend reading Using Python's pip to Manage Your Projects' Dependencies, which is a really good introduction on the mechanics of Python package management and helps you troubleshoot if you run into errors.

Upgrade pip to the latest version: 

python -m pip install --upgrade pip

🌱 Git

Ensure you have Git installed. If not, download and install it from the official Git website. Check your version:

git --version

🐳 Docker & Docker Compose

To demonstrate HESTIA Asynchronous Logger using Docker, ensure you have Docker and Docker Compose installed. Download and install Docker from the official website:

Verify installation with: 

docker version

docker compose version

Why Docker?

  • Runs Hestia services in isolated containers
  • Makes it easier to deploy logging services like Elasticsearch, Kibana, and Grafana

Now that prerequisites are set, continue with configuration. 🎯