Option A: ZIP download
Use Code -> Download ZIP on GitHub, unpack locally, open terminal in the unpacked folder.
Didactic onboarding
Installation for non-technical users. Simple path from download to first successful run.
This page is optimized for first-time users. If you need reproducible engineering workflows and diagnostics, use the professional track.
Step 1
Get the repository (link, download, unpack)
Option B: Git clone
git clone https://github.com/vfi64/wrapper.git
Then enter the directory.
Step 2-4
Prerequisites, install, start
| Topic | Instruction |
|---|---|
| Prerequisites | Python 3.10+, terminal access, internet for package install and provider APIs. |
| Install dependencies | bash scripts/setup_venv.sh |
| Activate virtual env | source .venc/bin/activate |
| Start wrapper | python Comm-SCI-Control-App.py |
| Optional base test | python -m pytest -q tests |
Step 5
Create and configure API keys
| Provider | Create key | Pricing |
|---|---|---|
| Gemini | aistudio.google.com/apikey | ai.google.dev/pricing |
| OpenRouter | openrouter.ai/keys | openrouter.ai/models |
| Hugging Face | huggingface.co/settings/tokens | huggingface.co/pricing |
Keys can be provided via environment variables or local
Config/Comm-SCI-API-Keys.json.
For team/production-like setups, prefer environment variables.
| Storage mode | Wrapper behavior |
|---|---|
api_key_plain |
Stored locally as plaintext. No passphrase dialog on startup or provider switch. |
api_key_enc |
Stored locally encrypted. Passphrase dialog appears whenever that provider is activated. |
Manage keys in-app via panel section Provider & LLM, then click API-Key, select provider, and save.
Important
Key confidentiality and cost awareness
Protect keys
Never place API keys in screenshots, chats, issue trackers, or public repositories.
Cost notice
Model usage can generate costs. Verify provider pricing and limits before productive use.
If a key leaks
Revoke immediately, rotate credentials, and update local/runtime configuration.