Graph-Native Infrastructure for Context and Accountable AI Systems
Python agent-memoryaiai-governanceai-infrastructureartificial-intelligencecontext-engineeringcontext-graphsdata-engineeringdecision-intelligencedeveloper-toolsexplainable-aigenerative-aigraph-ragknowledge-graphllmontologyprovenancepythonreasoningsemantic-search
title: "Installation" description: "Get Semantica installed in under a minute." icon: "download"
**Available on PyPI**: `pip install semantica` and you're ready. Python 3.11 or higher is required (3.11–3.13 are supported). Python 3.10 support ended in 0.8.0; on 3.10, pip installs the last release that supports it (0.7.x).System Requirements
| Component | Minimum | Recommended |
|---|---|---|
| Python | 3.11 | 3.11–3.13 |
| OS | Windows / Linux / Mac | Linux / Mac |
| RAM | 4 GB | 16 GB+ |
| Storage | 2 GB | 20 GB+ (models and data) |
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, and CuPy. ```bash pip install semantica[viz] ``` Includes PyVis, Graphviz, and 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, and 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 . --group dev # dev tools (pytest, black, etc.); needs pip 25.1+, or use `uv sync`
Install directly from the main branch if the PyPI release has issues:
pip install git+https://github.com/semantica-agi/semantica.git@main
Troubleshooting
Make sure you're in the right virtual environment:
pip list | grep semantica
pip install --upgrade semantica
pip install --upgrade pip
pip install build wheel
pip install semantica --no-deps # install core first, then add extras
Install CPU-only first, then layer in GPU support:
pip install semantica
pip install semantica[gpu]
pip install --user semantica # or use a virtual environment
Fixed in v0.5.0. Upgrade to the latest release:
pip install --upgrade semantica
Install the Microsoft Visual C++ Redistributable. This is a Windows system dependency, not a Semantica bug.
Next Steps
- Getting Started: understand what Semantica does before you build.
- Build the Pipeline: follow the end-to-end workflow with code.
- Browse Examples: see notebook examples organized by use case.