mirror of
https://github.com/semantica-agi/semantica.git
synced 2026-08-29 04:26:20 +00:00
Mohd Kaif
25289023fe
- Fix What's new → link in Info banner (now a proper <a> tag, always clickable) - Replace 4-stat CardGroup on index with inline premium stats row - Convert every <CardGroup>/<Card> block site-wide to markdown bullet lists: content sections → bold-title bullets with sub-bullets, nav cards → [Title](href) — description - Add cursor-animated list item hover effects to custom.css: green inset left border, subtle background tint, marker color change on hover - Affects index, getting-started, quickstart, concepts, modules, faq, architecture, installation, cookbook, glossary, learning-more, explorer-setup, cli-setup, community, contributing-guide, governance, citation, project-license, all integrations pages, and all 20+ reference module pages
189 lines
3.9 KiB
Markdown
189 lines
3.9 KiB
Markdown
---
|
|
title: "Installation"
|
|
description: "Get Semantica installed in under a minute."
|
|
icon: "download"
|
|
---
|
|
|
|
<Check>
|
|
**Available on PyPI**: `pip install semantica` and you're ready.
|
|
</Check>
|
|
|
|
<Note>
|
|
Python 3.8 or higher is required. Python 3.11+ is recommended.
|
|
</Note>
|
|
|
|
## 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+ (models and data) |
|
|
|
|
|
|
## Basic Installation
|
|
|
|
```bash
|
|
pip install semantica
|
|
```
|
|
|
|
With all optional dependencies:
|
|
|
|
```bash
|
|
pip install semantica[all]
|
|
```
|
|
|
|
### Verify
|
|
|
|
```bash
|
|
python -c "import semantica; print(semantica.__version__)"
|
|
```
|
|
|
|
|
|
## Virtual Environment (Recommended)
|
|
|
|
<Tabs>
|
|
<Tab title="venv">
|
|
```bash
|
|
python -m venv venv
|
|
source venv/bin/activate # Linux / Mac
|
|
venv\Scripts\activate # Windows
|
|
pip install semantica
|
|
```
|
|
</Tab>
|
|
<Tab title="conda">
|
|
```bash
|
|
conda create -n semantica python=3.11
|
|
conda activate semantica
|
|
pip install semantica
|
|
```
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
|
|
## Optional Dependencies
|
|
|
|
Install only what you need:
|
|
|
|
<Tabs>
|
|
<Tab title="GPU">
|
|
```bash
|
|
pip install semantica[gpu]
|
|
```
|
|
Includes PyTorch with CUDA, FAISS GPU, and CuPy.
|
|
</Tab>
|
|
<Tab title="Visualization">
|
|
```bash
|
|
pip install semantica[viz]
|
|
```
|
|
Includes PyVis, Graphviz, and UMAP.
|
|
</Tab>
|
|
<Tab title="LLM Providers">
|
|
```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)
|
|
```
|
|
</Tab>
|
|
<Tab title="Cloud">
|
|
```bash
|
|
pip install semantica[cloud]
|
|
```
|
|
Includes AWS S3, Azure Blob, and Google Cloud Storage.
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
|
|
## Install from Source
|
|
|
|
For the latest development version or to contribute:
|
|
|
|
```bash
|
|
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.)
|
|
```
|
|
|
|
Install directly from the main branch if the PyPI release has issues:
|
|
|
|
```bash
|
|
pip install git+https://github.com/semantica-agi/semantica.git@main
|
|
```
|
|
|
|
|
|
## Troubleshooting
|
|
|
|
<AccordionGroup>
|
|
|
|
<Accordion title="ModuleNotFoundError: No module named 'semantica'" icon="circle-xmark">
|
|
|
|
Make sure you're in the right virtual environment:
|
|
|
|
```bash
|
|
pip list | grep semantica
|
|
pip install --upgrade semantica
|
|
```
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="Installation fails with dependency errors" icon="triangle-exclamation">
|
|
|
|
```bash
|
|
pip install --upgrade pip
|
|
pip install build wheel
|
|
pip install semantica --no-deps # install core first, then add extras
|
|
```
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="GPU dependencies fail to install" icon="bolt">
|
|
|
|
Install CPU-only first, then layer in GPU support:
|
|
|
|
```bash
|
|
pip install semantica
|
|
pip install semantica[gpu]
|
|
```
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="Permission denied" icon="lock">
|
|
|
|
```bash
|
|
pip install --user semantica # or use a virtual environment
|
|
```
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="Windows [all] install fails" icon="windows">
|
|
|
|
Fixed in **v0.5.0**. Upgrade to the latest release:
|
|
|
|
```bash
|
|
pip install --upgrade semantica
|
|
```
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="Windows PyTorch DLL errors on startup" icon="windows">
|
|
|
|
Install the [Microsoft Visual C++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe). This is a Windows system dependency, not a Semantica bug.
|
|
|
|
</Accordion>
|
|
|
|
</AccordionGroup>
|
|
|
|
|
|
## Next Steps
|
|
|
|
- [Getting Started](getting-started) — Understand what Semantica does before you build.
|
|
- [Build the Pipeline](quickstart) — Follow the end-to-end workflow with code.
|
|
- [Browse Examples](cookbook) — See notebook examples organized by use case.
|