semantica/docs/installation.md

title, description, icon

title	description	icon
Installation	Get Semantica installed in under a minute.	download

**Available on PyPI** — `pip install semantica` and you're ready. Python 3.8 or higher required. Python 3.11+ recommended. Once you're set up, read [Getting Started](getting-started) for the overview and [Quickstart](quickstart) for the end-to-end pipeline.

---

Basic Installation

pip install semantica

With all optional dependencies:

pip install semantica[all]

Verify

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

---

Virtual Environment (Recommended)

```bash python -m venv venv source venv/bin/activate # Linux / Mac venv\Scripts\activate # Windows pip install semantica ``` ```bash conda create -n semantica python=3.11 conda activate semantica pip install semantica ```

---

Optional Dependencies

Install only what you need:

```bash pip install semantica[gpu] ``` Includes PyTorch with CUDA, FAISS GPU, CuPy. ```bash pip install semantica[viz] ``` Includes PyVis, Graphviz, UMAP. ```bash 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)
```

```bash pip install semantica[cloud] ``` Includes AWS S3, Azure Blob, Google Cloud Storage.

---

Install from Source

For the latest development version or to contribute:

git clone https://github.com/semantica-agi/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/semantica-agi/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 [all] install fails

This was fixed in v0.5.0. Upgrade to the latest release:

pip install --upgrade semantica

Windows PyTorch DLL errors

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

---

System Requirements

Component	Minimum	Recommended
Python	3.8	3.11+
OS	Windows / Linux / Mac	Linux / Mac
RAM	4 GB	16 GB+
Storage	2 GB	20 GB+ (for models and data)

---

Next Steps

Understand what Semantica does before you build. Follow the end-to-end workflow with code. See notebook examples organized by use case.