mirror of
https://github.com/semantica-agi/semantica.git
synced 2026-08-30 04:40:16 +00:00
KaifAhmad1
9113ef3428
- Rewrote all 26 reference module pages: removed blockquote taglines and horizontal rule separators, added "What You Get" bullet summaries, added constructor/method parameter tables, expanded thin files (graph_store, triplet_store, visualization, provenance) with full API coverage, added backend comparison tables and real-world usage patterns - Renamed Modules tab from "API Reference" and group from "Context & Knowledge" to "Context & Intelligence" in docs.json - Fixed logo: copied "Semantica Logo.png" to web-safe semantica-logo.png and updated all 4 references in docs.json - Improved core docs (index, modules, concepts, quickstart, installation, getting-started) with better fonts, bullet points, and complete module listings (mcp_server, evals, core, utils previously missing) - Rewrote community pages (community, community-projects, contributing-guide, use-cases, architecture, faq, learning-more, glossary) with heading hierarchy fixes, expanded definitions, and better structure - Fixed markdown linter warnings: MD036 bold-as-heading, MD001 heading skips, MD040 missing code fence language, MD032 blank lines around lists
175 lines
3.7 KiB
Markdown
175 lines
3.7 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
|
|
|
|
### ModuleNotFoundError
|
|
|
|
Make sure you're in the right environment:
|
|
|
|
```bash
|
|
pip list | grep semantica
|
|
pip install --upgrade semantica
|
|
```
|
|
|
|
### Installation fails with dependency errors
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
pip install semantica
|
|
pip install semantica[gpu]
|
|
```
|
|
|
|
### Permission denied
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
pip install --upgrade semantica
|
|
```
|
|
|
|
### Windows PyTorch DLL errors
|
|
|
|
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.
|
|
|
|
## Next Steps
|
|
|
|
<CardGroup cols={3}>
|
|
<Card title="Getting Started" icon="rocket" href="getting-started">
|
|
Understand what Semantica does before you build.
|
|
</Card>
|
|
<Card title="Build the Pipeline" icon="play" href="quickstart">
|
|
Follow the end-to-end workflow with code.
|
|
</Card>
|
|
<Card title="Browse Examples" icon="flask" href="cookbook">
|
|
See notebook examples organized by use case.
|
|
</Card>
|
|
</CardGroup>
|