mirror of
https://github.com/semantica-agi/semantica.git
synced 2026-08-29 04:26:20 +00:00
docs: premium UI improvements — navbar links, hover effects, inline tips, accordion troubleshooting (#646)
- Move Discord, GitHub, PyPI, and Follow on X links from sidebar anchors to top-right navbar - Lock dark mode as default via appearance.strict and hide theme toggle - Add custom.css with hover highlighting for tables, code blocks, cards, callouts, and inline code - Move all Tips and Common Pitfalls sections inline next to their relevant content across all 25 reference docs - Polish context.md: remove duplicates, condense callouts, upgrade Cookbooks to CardGroup - Convert Troubleshooting and Performance Optimization sections in installation.md, cli-setup.md, explorer-setup.md, learning-more.md, and faq.md from plain headers to AccordionGroup - Change navigation-hint Tip callouts to Info in concepts.md, faq.md, glossary.md, and modules.md
This commit is contained in:
+26
-10
@@ -120,50 +120,66 @@ pip install git+https://github.com/semantica-agi/semantica.git@main
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### ModuleNotFoundError
|
||||
<AccordionGroup>
|
||||
|
||||
Make sure you're in the right environment:
|
||||
<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
|
||||
```
|
||||
|
||||
### Installation fails with dependency errors
|
||||
</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 without optional deps first
|
||||
pip install semantica --no-deps # install core first, then add extras
|
||||
```
|
||||
|
||||
### GPU dependencies fail
|
||||
</Accordion>
|
||||
|
||||
Install CPU-only first, then add GPU support:
|
||||
<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]
|
||||
```
|
||||
|
||||
### Permission denied
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Permission denied" icon="lock">
|
||||
|
||||
```bash
|
||||
pip install --user semantica # or use a virtual environment
|
||||
```
|
||||
|
||||
### Windows `[all]` install fails
|
||||
</Accordion>
|
||||
|
||||
This was fixed in **v0.5.0**. Upgrade to the latest release:
|
||||
<Accordion title="Windows [all] install fails" icon="windows">
|
||||
|
||||
Fixed in **v0.5.0**. Upgrade to the latest release:
|
||||
|
||||
```bash
|
||||
pip install --upgrade semantica
|
||||
```
|
||||
|
||||
### Windows PyTorch DLL errors
|
||||
</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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user