mirror of
https://github.com/semantica-agi/semantica.git
synced 2026-08-29 04:26:20 +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
3.7 KiB
3.7 KiB
title, description, icon
| title | description | icon |
|---|---|---|
| Installation | Get Semantica installed in under a minute. | download |
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
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 ".[dev]" # dev tools (pytest, black, etc.)
Install directly from the main branch if the PyPI release has issues:
pip install git+https://github.com/semantica-agi/semantica.git@main
Troubleshooting
ModuleNotFoundError
Make sure you're in the right environment:
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.