mirror of https://github.com/semantica-agi/semantica.git synced 2026-08-29 04:26:20 +00:00

Files

T

Mohd KaifandClaude Sonnet 4.6 b282487b17 docs: rewrite and polish documentation site (#413 )

- Rewrote index.md to match README (tagline, badges, Problem/Solution text)
- Improved getting-started, concepts, quickstart, installation, faq, use-cases, contributing, glossary, learning-more, examples, modules, architecture, cookbook, deep-dive pages: tighter prose, fixed headings/bullets, removed inconsistencies and duplicate sections
- Removed overuse of emojis from headings in integration pages (docling, snowflake)
- Fixed change_management reference page: closed unclosed JSON code block that broke the right TOC, demoted noisy sub-headings to bold text
- CSS layout: widened content area (max-width 1440px grid, left sidebar 11rem, right TOC narrowed to 11rem for broader content), tightened TOC spacing and font size, fixed word-wrap/overflow on TOC links
- Added mkdocs_local.yml for local serving without mkdocs-jupyter plugin

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-26 18:38:21 +05:30

3.2 KiB

Raw Blame History

Installation

Get Semantica installed in under a minute.

!!! success "Available on PyPI" pip install semantica — that's it.

!!! note "Requirements" Python 3.8 or higher. Python 3.11+ recommended.

Basic Installation

pip install semantica

With all optional dependencies:

pip install semantica[all]

Verify

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

Virtual Environment (Recommended)

=== "venv"

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

=== "conda"

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

Optional Dependencies

Install only what you need:

=== "GPU"

```bash
pip install semantica[gpu]
```
Includes PyTorch with CUDA, FAISS GPU, CuPy.

=== "Visualization"

```bash
pip install semantica[viz]
```
Includes PyVis, Graphviz, UMAP.

=== "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)
```

=== "Cloud"

```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/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

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

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

3.2 KiB Raw Blame History