Metadata-Version: 2.4
Name: vastian
Version: 1.1.2
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-Expression: LicenseRef-Proprietary
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.

## Install

```bash
pip install vastian
```

## Quick Start

```bash
vastian serve          # Start the web UI (http://127.0.0.1:4545)
vastian chat           # Interactive CLI with agents
```

## Key Commands

| Command | Description |
|---------|-------------|
| `vastian serve` | Start the unified app (dashboard, copilot, boards) |
| `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 |

## Desktop App

Download the installer for [Windows](https://vastianconnect.com) or [macOS](https://vastianconnect.com). The desktop app bundles the backend and runs the same unified UI in a native window.

## Configuration

- **First run:** The app creates a data folder. You can set `VASTIAN_DATA_ROOT` to choose the location.
- **LLM provider:** Configure via the Settings page in the app, or set `VASTIAN_LLM_PROVIDER` and API keys in `.env`.

## Troubleshooting (Desktop App)

**Backend won't start from the installer**

1. **Check the log:**  
   - Windows: `%LOCALAPPDATA%\com.vastian\logs\vastian.log` or `%LOCALAPPDATA%\Vastian\logs\vastian.log`  
   - macOS: `~/Library/Application Support/com.vastian/logs/vastian.log`

2. **Run from Command Prompt** to see errors: open cmd, go to the install folder (e.g. `C:\Users\YourName\AppData\Local\Programs\Vastian`), run `Vastian.exe`. Stderr appears in the console.

3. **First launch** can take 60–90s — PyInstaller extracts on first run.

4. **Port 4545** must be free. Check with `netstat -an | findstr 4545` (Windows) or `lsof -i :4545` (macOS).

5. **Antivirus** may block `vastian-backend.exe` — add an exception if needed.

## More

- [vastianconnect.com](https://vastianconnect.com) — Documentation and downloads
