Pushing the boundaries of AI storytelling
Advanced AI agents • Customizable response formatting • Flexible prompt editing • Immersive roleplaying

▶️ Click the image above to watch the demo video

🤖 Complete AI Agent Control

• Design agents with custom prompts, output schemas, and response formatting
• Import character cards (v2/v3) or build your own from scratch
• Support for 10+ AI providers: OpenAI, Anthropic, Google AI, DeepSeek, Ollama, xAI, and more

🎨 Visual Flow(AI agent workflow) Editor

• Drag-and-drop interface for complex conversation flows
• Branch narratives with conditional logic (coming soon)
• Real-time prompt preview and testing with actual roleplay sessions

🔐 100% Local-First

• All data stored locally on your device - your stories stay yours
• No account required, no data collection
• Export and backup your content anytime

📱 True Cross-Platform

• Progressive Web App - works on any device with a browser
• Native desktop apps for Windows, macOS, and Linux (coming soon)
• Offline support (PWA) with full functionality

• Built with modern tech: React, TypeScript, Vite, and Tailwind CSS
• Database in your browser: PGlite (PostgreSQL compiled to WebAssembly)
• Blazing fast: Local database, service worker caching, and optimized bundle sizes

• Cross-device sync - Continue your stories seamlessly across devices
• Enhanced session customization - More control over every aspect of your roleplay
• Community features - Share and discover amazing stories and characters

• ✨ Features
• 🚀 Installation
• 🛠️ Development
• 🏠 Self-hosting
• 🤝 Contributing
• ⚖️ License
• 🌐 References

• Download installation file on latest release:
  • For Windows: astrsk-X.Y.Z.exe
  • For Mac: astrsk-X.Y.Z.dmg
  • For Linux (Not tested): astrsk-X.Y.Z.AppImage

Before you begin, ensure you have the following installed:

• Node.js (v22 or higher)
• pnpm (v10 or higher)

• Frontend: React, TypeScript, Vite
• Styling: Tailwind CSS
• State Management: TanStack Query (React Query) + Zustand
• UI Components: shadcn/ui (built on Radix UI)
• Database: PGlite (PostgreSQL WASM) - Local only
• AI SDKs: Vercel AI SDK with multiple providers
• PWA: Vite PWA plugin
• Desktop: Electron wrapper with auto-updater

astrsk/
└── apps/
    ├── pwa/                # Main PWA application
    │   ├── src/
    │   │   ├── modules/    # Domain modules (DDD structure)
    │   │   │   ├── agent/
    │   │   │   ├── flow/
    │   │   │   └── session/
    │   │   ├── app/        # Application layer
    │   │   ├── components/ # shadcn/ui components
    │   │   ├── db/         # Database schema and migrations
    │   │   └── shared/     # Shared utilities
    │   └── public/
    └── electron/           # Electron wrapper (native desktop app)
        ├── build/          # Build resources (icons, entitlements)
        ├── resources/      # Application resources
        ├── src/
        │   ├── main/       # Main process (window management, IPC)
        │   ├── preload/    # Preload scripts (secure bridge)
        │   └── shared/     # Shared types and constants
        ├── electron.vite.config.ts
        ├── electron-builder.yml     # Production build config
        └── tsconfig.*.json          # TypeScript configs

# Install dependencies
$ pnpm install

# Run PWA dev server
$ pnpm dev:pwa

# Build PWA application
$ pnpm build:pwa

# Run electron dev application
$ pnpm dev:electron

# Build electron application
$ pnpm build:electron

PWA apps use technologies like OPFS, PGlite and service worker to store data completely in the browser. These technologies require a secure context. If you want to self-host a PWA app and access it through LAN, you need to add SSL settings as follows.

First, add the @vitejs/plugin-basic-ssl development dependency.

$ pnpm --filter pwa add -D @vitejs/plugin-basic-ssl

Add the following settings to the Vite configuration file apps/pwa/vite.config.ts.

// ... Other imports
// Import vite basic ssl plugin
import basicSsl from "@vitejs/plugin-basic-ssl";

export default defineConfig({
  // ... Other configs

  plugins: [
    // ... Other plugins
    // Add vite basic ssl plugin
    basicSsl(),
  ],

  // Add server config
  server: {
    host: true, // Listen on all LAN and public addresses
  },
});

Now when you run the PWA server, additional addresses that can be accessed through the Network will be displayed as follows. The following address is an example, and this address will vary depending on your environment.

$ pnpm dev:pwa
...
pwa:dev:   VITE v6.3.5  ready in 500 ms
pwa:dev: 
pwa:dev:   ➜  Local:   https://localhost:5173/
pwa:dev:   ➜  Network: https://172.30.1.34:5173/
pwa:dev:   ➜  Network: https://169.254.224.249:5173/
pwa:dev:   ➜  press h + enter to show help

Now try accessing from other devices on the network using the displayed address. Since it's a self-signed certificate, the browser will block access. In Chrome, you can connect by clicking Advanced > Proceed to xxx.xxx.xxx.xxx (unsafe).

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the AGPL-v3 License - see the LICENSE file for details.

• Website: astrsk.ai
• User Documentation: docs.astrsk.ai
• Discord: astrsk.ai
• Reddit: r/astrsk_ai
• Twitter/X: @astrskai
• LinkedIn: astrsk-ai
• Medium: astrsk-ai

Made with ❤️ by the astrsk.ai team