Deploy AI agents. Control from anywhere. High-performance, local-first agent management.
- Bun (recommended) or Node.js 18+
- Convex account
- Clerk account
- Fly.io account or Docker Desktop (for agent hosting)
# Clone
git clone https://github.com/xa-x/swrm.git
cd swrm
# Install dependencies
bun install
# Set up Convex backend
npx convex dev
# Configure environment
cp .env.local.example .env.local
# Edit .env.local with your Convex URL and Clerk keys
# Run the app (Expo)
bun run startSwrm follows a Hybrid Sync architecture for maximum responsiveness and reliability:
- Source of Truth (Cloud): Convex handles real-time database state, server-side functions, and agent orchestration.
- Local-First (Mobile): Expo + SQLite ensures the app remains functional and snappy even with poor connectivity.
- Reactive Sync: The mobile app subscribes to Convex queries and automatically syncs changes to the local SQLite cache.
- Agent Hosting: Agents run in isolated containers on Fly.io (Production) or Docker (Development).
swrm/
├── app/ # Expo Router (Tabs, Auth, Screens)
├── convex/ # Convex Backend (Schema, Mutations, Actions)
├── components/ # Reusable UI Components (Uniwind + Reanimated)
├── lib/ # Core Utilities & Hooks
│ ├── db.ts # Local SQLite (Offline Cache)
│ ├── hooks.ts # Custom Hooks
│ └── containers.ts # Container Orchestration Logic
├── providers/ # Context Providers (Auth, Convex)
├── assets/ # Static Assets (Images, Fonts)
└── package.json # Unified dependency management
- Real-time Sync - Instant updates via Convex subscriptions.
- Local-First Cache - SQLite integration for offline persistence.
- AI Orchestration - Deploy and manage agents via Fly.io or Docker.
- Modern UI - Styled with Uniwind (Tailwind for Native) and Reanimated.
- Secure Auth - Integrated with Clerk for seamless, secure user management.
- Action Logging - Full audit trail for every agent interaction.
- Push Notifications - Stay updated on agent tasks and status.
EXPO_PUBLIC_CONVEX_URL=https://your-name.convex.cloud
EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_... # For backend actions if neededEnsure your Convex project is linked:
npx convex devnpx convex deployeas build --platform ios
# or
eas build --platform android- Convex: Free tier supports up to 100K function calls/month.
- Fly.io: Agents cost approx. $0.50 - $2.00/month depending on usage and instance size.
- End-to-End Auth: Clerk + Convex OIDC integration.
- Isolation: Each agent runs in its own secure container.
- Encrypted Keys: API keys are handled securely within the Convex environment.
MIT
Built with ❤️ by xa-x