Installation¶

Get Semantica installed in under a minute.

Basic Installation¶

pip install semantica

With all optional dependencies:

pip install semantica[all]

Verify¶

python -c "import semantica; print(semantica.__version__)"

Virtual Environment (Recommended)¶

python -m venv venv
source venv/bin/activate      # Linux / Mac
venv\Scripts\activate         # Windows
pip install semantica

conda create -n semantica python=3.11
conda activate semantica
pip install semantica

Optional Dependencies¶

Install only what you need:

pip install semantica[gpu]

pip install semantica[viz]

pip install semantica[llm-all]          # all providers

pip install semantica[llm-openai]       # OpenAI
pip install semantica[llm-anthropic]    # Anthropic
pip install semantica[llm-gemini]       # Google Gemini
pip install semantica[llm-groq]         # Groq
pip install semantica[llm-ollama]       # Ollama (local)

pip install semantica[cloud]

Install from Source¶

For the latest development version or to contribute:

git clone https://github.com/Hawksight-AI/semantica.git
cd semantica

pip install -e .          # core only
pip install -e ".[all]"   # all extras
pip install -e ".[dev]"   # dev tools (pytest, black, etc.)

If you encounter issues with the PyPI release, install directly from the main branch:

pip install git+https://github.com/Hawksight-AI/semantica.git@main

Troubleshooting¶

ModuleNotFoundError¶

Check you have the right environment active:

pip list | grep semantica
pip install --upgrade semantica

Installation fails with dependency errors¶

pip install --upgrade pip
pip install build wheel
pip install semantica --no-deps   # install without optional deps first

GPU dependencies fail¶

Install CPU-only first, then add GPU support:

pip install semantica
pip install semantica[gpu]

Permission denied¶

pip install --user semantica      # or use a virtual environment

Windows PyTorch DLL errors¶

Install the Microsoft Visual C++ Redistributable. This is a Windows system dependency, not a Semantica bug.

System Requirements¶

Next Steps¶

• Getting Started — build your first knowledge graph
• Quickstart Tutorial — full step-by-step pipeline
• Cookbook — interactive Jupyter notebook tutorials