vastian 1.0.1

The Vastian Network — A distributed multi-agent system for personal and professional knowledge management with MARL-inspired Mentor Council collaboration.

Vastian Network

A distributed multi-agent system for personal and professional knowledge management, with MARL-inspired Mentor Council collaboration.

Quick Start

# Use project venv (recommended — avoids global pip pollution)
python -m venv .venv
.venv\Scripts\activate   # Windows
# source .venv/bin/activate   # Linux/macOS

pip install -e ".[dev,mcp]"
vastian chat          # Interactive chat with agents
vastian /inbox        # Inbox status
vastian /report <id>  # Delegation report

Venv note: Install in the project venv, not globally. If markdown or other deps were installed globally, run pip uninstall markdown -y (outside venv) then pip install -e . inside venv.

Key Commands

• vastian chat — Interactive session; use /help for commands
• vastian setup gdrive / vastian setup dropbox — Backup storage OAuth
• vastian backup-panel — Web UI for backup config
• vastian worker — Background task processor
• vastian giga push / vastian giga pull — Giga memory sync

See ARCHITECTURE.md for system design.

PyPI (pip install vastian)

pip install build twine
python -m build
twine upload dist/*  # twine upload dist/*.whl dist/*.tar.gz

Create a PyPI account and API token first. See packaging.python.org.

Desktop App

Dev testing (after code changes)

# Backend only — open http://127.0.0.1:4545 in browser
vastian serve

# Full Tauri app (backend starts automatically)
cd neptune && npm run dev

No build step needed — Python runs from source via the venv.

If you hit a "Permission Denied" Tauri build error, kill stale sidecar processes: taskkill /F /IM vastian-backend.exe (Windows) or pkill vastian-backend (macOS/Linux).

Release / installer build

rustup update
pip install pyinstaller
python scripts/build_binary.py --clean   # freeze backend into .exe
powershell -ExecutionPolicy Bypass -File scripts\prepare_vastian.ps1   # copy sidecar binary  - ./scripts/prepare_vastian.sh
cd neptune && npm run build              # produce installer (.msi / .dmg)

See neptune/README.md for desktop app details.

Troubleshooting installed app ("Backend failed to start")

1. Run from Command Prompt to see errors — open cmd, navigate to the install folder (e.g. C:\Users\YourName\AppData\Local\Programs\Vastian or C:\Program Files\Vastian), run Vastian.exe. Stderr will show backend spawn/crash messages.
2. First launch can take 60–90s — PyInstaller extracts on first run. Wait for the loading screen.
3. Antivirus may block vastian-backend.exe — add an exception if needed.
4. Port 4545 must be free. Check with netstat -an | findstr 4545.