Metadata-Version: 2.4
Name: vastian
Version: 1.0.0
Summary: The Vastian Network — A distributed multi-agent system for personal and professional knowledge management with MARL-inspired Mentor Council collaboration.
Author: Rowan Neri
License: Proprietary License
        
        Copyright (c) Vastian Visionary. All rights reserved.
        
        This software is proprietary. Unauthorized copying, distribution, modification,
        or use of this software, in whole or in part, without prior written permission
        from the copyright holder is strictly prohibited.
        
Project-URL: Homepage, https://vastianconnect.com
Project-URL: Documentation, https://vastianconnect.com
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.115.0
Requires-Dist: python-multipart>=0.0.6
Requires-Dist: uvicorn>=0.32.0
Requires-Dist: markdown>=3.5.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: openai>=1.14.0
Requires-Dist: anthropic>=0.21.0
Requires-Dist: pydantic>=2.6.0
Requires-Dist: pydantic-settings>=2.2.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: chromadb>=0.4.24
Requires-Dist: rich>=13.7.0
Requires-Dist: typer>=0.9.0
Requires-Dist: jinja2>=3.1.3
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: questionary>=2.1.0
Requires-Dist: google-api-python-client>=2.100.0
Requires-Dist: google-auth-oauthlib>=1.2.0
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == "mcp"
Provides-Extra: plaid
Requires-Dist: plaid-python>=17.0.0; extra == "plaid"
Provides-Extra: storage
Requires-Dist: dropbox>=11.0.0; extra == "storage"
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: ruff>=0.3.0; extra == "dev"
Requires-Dist: mypy>=1.8.0; extra == "dev"
Provides-Extra: build
Requires-Dist: pyinstaller>=6.0.0; extra == "build"
Dynamic: license-file

# Vastian Network

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

## Quick Start

```bash
# 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](ARCHITECTURE.md) for system design.

## PyPI (pip install vastian)

```bash
pip install build twine
python -m build
twine upload dist/*
```

Create a [PyPI account](https://pypi.org/account/register/) and API token first. See [packaging.python.org](https://packaging.python.org/en/latest/tutorials/packaging-projects/).

## Desktop App

### Dev testing (after code changes)

```bash
# 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

```bash
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](neptune/README.md) for desktop app details.
