mengzhx/semantica
1
0
Fork 0
mirror of https://github.com/semantica-agi/semantica.git synced 2026-09-11 04:01:32 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: premium UI improvements — navbar links, hover effects, inline tips, accordion troubleshooting (#646)

Browse Source 
- 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:
Mohd Kaif
2026-06-17 18:59:25 +05:30
committed by GitHub
parent a326c7d3bd
commit e04dc12e6e
30 changed files with 723 additions and 593 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/cli-setup.md
+22 -8
View File
@@ -169,9 +169,11 @@ No other environment variables are read by these commands.
## Troubleshooting
### `command not found`
<AccordionGroup>
The executables are placed in the `bin/` (Linux/Mac) or `Scripts/` (Windows) directory of the active Python environment. If the command is not found, that directory is likely not on `PATH`.
<Accordion title="command not found" icon="terminal">
The executables land in `bin/` (Linux/Mac) or `Scripts/` (Windows) of the active Python environment. If the command is not found, that directory is likely not on `PATH`.
Activate your virtual environment first:
@@ -185,23 +187,27 @@ Find where pip placed the scripts:
```bash
python -m site --user-scripts # user-level install
pip show -f semantica # shows installed files
pip show -f semantica # shows all installed files
```
### Command found but crashes on import
</Accordion>
<Accordion title="Command found but crashes on import" icon="triangle-exclamation">
```bash
pip install --upgrade semantica
python -c "import semantica; print(semantica.__version__)"
```
If you have multiple Python environments, make sure you are installing into the same one the shell resolves:
If you have multiple Python environments, install into the one the shell resolves:
```bash
python -m pip install semantica
```
### `semantica-explorer`: "uvicorn is required"
</Accordion>
<Accordion title="semantica-explorer: uvicorn is required" icon="map">
The Explorer extras are not included in the base install:
@@ -209,7 +215,9 @@ The Explorer extras are not included in the base install:
pip install semantica[explorer]
```
### `semantica-mcp` silent failure in a MCP client
</Accordion>
<Accordion title="semantica-mcp silent failure inside a MCP client" icon="plug">
The MCP server communicates over stdio. Test it directly from the shell first:
@@ -219,10 +227,16 @@ echo '{"jsonrpc":"2.0","id":1,"method":"ping","params":{}}' | semantica-mcp
A response of `{"jsonrpc":"2.0","id":1,"result":{}}` confirms the server is working. If you see nothing, check that the command is on `PATH` and the base package is installed.
### Windows: DLL errors on startup
</Accordion>
<Accordion title="Windows: 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 required by PyTorch and related packages, not a Semantica bug.
</Accordion>
</AccordionGroup>
## Next Steps