|
Download docs/STARTUP_FLOWCHART.md from polyHedra/PolyHedra: direct link, hf CLI and curl.
- Browser
- Download file 6.26 kB
-
https://huggingface.co/spaces/polyHedra/PolyHedra/resolve/main/docs/STARTUP_FLOWCHART.md
- Command line
-
hf download hf://spaces/polyHedra/PolyHedra/docs/STARTUP_FLOWCHART.md
-
curl -L -o STARTUP_FLOWCHART.md https://huggingface.co/spaces/polyHedra/PolyHedra/resolve/main/docs/STARTUP_FLOWCHART.md
6.26 kB
| # Polyhedra Startup Flowchart | |
| ``` | |
| βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ | |
| β Polyhedra MCP Server β | |
| β Startup Flow β | |
| βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ | |
| Start | |
| β | |
| βΌ | |
| ββββββββββββββββββββββββββ | |
| β Dependencies installed?β | |
| β pip install -e . β | |
| βββββββββ¬βββββββββββββββββ | |
| β | |
| Yes β No | |
| βββββββββββββ΄βββββββββββββ | |
| β β | |
| βΌ βΌ | |
| ββββββββββββββββ ββββββββββββββββββββ | |
| β Run diagnosticβ β Install deps β | |
| β test_quick β β pip install -e . β | |
| ββββββββ¬ββββββββ ββββββββββ¬ββββββββββ | |
| β β | |
| β Pass β | |
| β β | |
| ββββββββββββ¬ββββββββββββββββ | |
| β | |
| βΌ | |
| βββββββββββββββββββββββ | |
| β Config updated? β | |
| β .vscode/settings.jsonβ | |
| βββββββββββ¬ββββββββββββ | |
| β | |
| Yes β No | |
| βββββββββββββ΄ββββββββββββββ | |
| β β | |
| βΌ βΌ | |
| βββββββββββββββ ββββββββββββββββββββββ | |
| β Reload β β See FIX_GUIDE.md β | |
| β VS Code β β Update config β | |
| β Ctrl+Shift+P β ββββββββββββββββββββββ | |
| ββββββββ¬βββββββ | |
| β | |
| βΌ | |
| βββββββββββββββββββββββ | |
| β MCP server auto-startsβ | |
| β (runs in background) β | |
| ββββββββ¬βββββββββββββββ | |
| β | |
| βΌ | |
| βββββββββββββββββββββββ | |
| β Check output panel β | |
| β Ctrl+Shift+U -> MCP β | |
| ββββββββ¬βββββββββββββββ | |
| β | |
| βΌ | |
| βββββββββββββββββββββββββββ | |
| β See "Server ready"? β | |
| ββββββ¬ββββββββββββ¬ββββββββββ | |
| β β | |
| Yesβ β No | |
| β β | |
| βΌ βΌ | |
| ββββββββββ ββββββββββββββββ | |
| β Success!β β Check errors β | |
| βββββ¬βββββ β See β | |
| β β FIX_GUIDE.md β | |
| β ββββββββββββββββ | |
| βΌ | |
| ββββββββββββββββββββββββββββ | |
| β Test in Copilot β | |
| β "Search transformer papers"β | |
| ββββββββββββββββββββββββββββ | |
| β | |
| βΌ | |
| ββββββββββββββββββββββββββββ | |
| β β¨ Start using Polyhedra!β | |
| ββββββββββββββββββββββββββββ | |
| ``` | |
| --- | |
| ## Quick Command Reference | |
| ### Windows PowerShell | |
| ```powershell | |
| # π Diagnostic and testing | |
| .\test_quick.ps1 # Quick diagnostic | |
| .\run_demo.ps1 # Run demo | |
| python test_fix.py # Detailed test | |
| # π§ Development commands | |
| .\.venv\Scripts\Activate.ps1 # Activate virtual environment | |
| python -m pytest # Run tests | |
| python demo_search.py # Run search demo | |
| # π Debug | |
| python -m polyhedra.server # Manually start server (Ctrl+C to stop) | |
| ``` | |
| ### Batch Files | |
| ```cmd | |
| test_quick.bat # Quick diagnostic | |
| run_demo.bat # Run demo | |
| ``` | |
| --- | |
| ## Three Usage Methods | |
| ### 1οΈβ£ Via IDE (Recommended) | |
| ``` | |
| VS Code starts | |
| β | |
| Auto-start MCP server | |
| β | |
| Use in Copilot chat | |
| β | |
| Polyhedra tools auto-called | |
| ``` | |
| **Advantages**: | |
| - β Auto-start | |
| - β No manual management | |
| - β Integrated in chat | |
| ### 2οΈβ£ Python Scripts | |
| ```python | |
| from polyhedra.services.semantic_scholar import SemanticScholarService | |
| import asyncio | |
| async def main(): | |
| service = SemanticScholarService() | |
| papers = await service.search("AI", limit=5) | |
| print(papers) | |
| asyncio.run(main()) | |
| ``` | |
| **Advantages**: | |
| - β Programmatic control | |
| - β Batch processing | |
| - β Custom workflows | |
| ### 3οΈβ£ Command Line Demo | |
| ```powershell | |
| .\run_demo.ps1 | |
| ``` | |
| **Advantages**: | |
| - β Quick testing | |
| - β Learn features | |
| - β No IDE needed | |
| --- | |
| ## Status Indicators | |
| ### β Running Normally | |
| ``` | |
| MCP output: [polyhedra] Server ready | |
| Copilot: Can call Polyhedra tools | |
| Test: test_quick.ps1 all pass | |
| ``` | |
| ### β οΈ Needs Check | |
| ``` | |
| MCP output: No logs | |
| Copilot: Can't see Polyhedra tools | |
| Test: Some failures | |
| ``` | |
| **Fix**: Reload VS Code | |
| ### β Has Problems | |
| ``` | |
| MCP output: Error messages | |
| Copilot: Tool call failures | |
| Test: Failed | |
| ``` | |
| **Fix**: See `FIX_GUIDE.md` | |
| --- | |
| ## Next Steps | |
| 1. β Ensure diagnostic passes: `.\test_quick.ps1` | |
| 2. π Reload VS Code | |
| 3. π Test in Copilot | |
| 4. π See `docs/USER_GUIDE.md` to learn more | |