|
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
# π 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
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
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
.\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
- β
Ensure diagnostic passes:
.\test_quick.ps1 - π Reload VS Code
- π Test in Copilot
- π See
docs/USER_GUIDE.mdto learn more