Docs
Seris is open source. The README in the repository is the full guide; this page is the short version.
Guides
Each guide covers one part of Seris.
- InstallDownload the macOS app, approve the first launch, upgrade, or run from source.
- ModelsCloud providers, compatible endpoints and local models in Ollama or LM Studio.
- MarketsData sources, search and watchlists, charts, contract prices and Longbridge.
- Strategies and backtestsDraft a TypeScript strategy, review it, and backtest it on Binance or Hyperliquid candles.
- PermissionsAsk every time or Allow all actions, per conversation, and Stop.
- AlertsPrice, change and funding alerts from Markets or Chat.
- TroubleshootingFirst launch, keychain prompts, model connections, data and news.
Install the macOS build
- Download Seris_0.1.2_aarch64.dmg from the latest release. It runs on Macs with Apple Silicon.
- Open the disk image and drag Seris.app to Applications.
- Seris is ad-hoc signed and not Apple-notarized. If macOS blocks the first launch, open System Settings → Privacy & Security → Open Anyway.
- Open Settings → Models, configure a provider and choose a default model. Testing a connection sends a short model request and may incur provider charges.
- To upgrade, quit Seris and replace the app in Applications; your conversations, watchlists and strategies stay.
Run from source
Use the Node version in .node-version, pnpm 12.5.1, Rust, and the Tauri build prerequisites for your operating system.
git clone https://github.com/aowang-ai/seris.git
cd seris
pnpm install --frozen-lockfile
pnpm tauri:devChecks: pnpm typecheck and pnpm test (offline; no live model or trading API calls). Package with pnpm tauri:build.
What's in v0.1.2
Features
Chat, Markets (Hyperliquid, Hyperliquid xyz, Binance spot and TradFi perpetuals, Longbridge), candlestick charts, watchlists, conditional alerts, strategies and local backtests on Binance spot and Hyperliquid candles, Models, English and Chinese.
New in 0.1.2
Backtest on real Hyperliquid perpetual candles, including HIP-3 markets like xyz:NVDA, alongside Binance spot. Each result records the data venue, candle range, fees and slippage.
New in 0.1.1
Choose Ask every time or Allow all actions per conversation; long tasks no longer stop at a fixed step limit.
Setup notes
Crypto news needs CRYPTOCOMPARE_API_KEY at launch. The installer is for Apple Silicon Macs.
Project structure
apps/coreAgent runtime, local gateway, tools, skills and persistent sessionsapps/desktop-uiReact / Vite / Tailwind interfaceapps/desktopTauri / Rust shell, process supervision and desktop packaging