Merge pull request #30 from restackio/update-readme

Author: martinibach

Diff for: readme.md

@@ -1,17 +1,70 @@
-# Run Restack Desktop
+# Restack Examples for Typescript
 
-Open restack-desktop.dmg and launch app
+Restack is an open source framework for building autonomous AI applications in TypeScript. It helps developers build resilient, autonomous AI workflows that can execute logic and API calls reliably, maintain state over weeks or months, and self-improve over time. The examples in this repository demonstrate how to build TypeScript applications using Restack's features.
 
-Restack Engine will run locally in the application
+## Quick Start
 
-# Alternative run Restack in Docker
+Start the Restack Engine and Web UI using Docker:
 
+```
 docker run -d --pull always --name studio -p 5233:5233 -p 6233:6233 -p 7233:7233 ghcr.io/restackio/engine:main
+```
 
-or
+Or using Docker Compose:
 
+```
 docker compose up -d --build --pull always
+```
 
-(will force repulling and rebuilding)
+The Restack Web UI will be available at http://localhost:5233
 
-Restack Desktop UI will be available at http://localhost:5233
+## Examples
+
+### Autonomous AI Examples
+
+- [examples/posthog](examples/posthog) - Analyzes PostHog session recordings and creates Linear digests
+
+
+[Find more autonomous examples](https://docs.restack.io/examples)
+
+### AI Integration Examples
+
+- [examples/openai](examples/openai) - Basic OpenAI integration example
+- [examples/gemini](examples/gemini) - Example using Google's Gemini model
+- [examples/voice](examples/voice) - Voice processing with Deepgram and OpenAI
+- [examples/composio](examples/composio) - Calendar event creation with AI
+
+### Framework Examples
+
+- [examples/get-started](examples/get-started) - Basic starter template
+- [examples/nextjs](examples/nextjs) - Integration with Next.js applications
+- [examples/human-loop](examples/human-loop) - Example of human-in-the-loop workflows
+
+## Documentation
+
+For detailed documentation and guides, visit [https://docs.restack.io/](https://docs.restack.io/)
+
+Join our community on [Discord](https://discord.com/invite/79JuDTNEQm) for support and discussions.
+
+## Local Restack Components
+
+### Restack Engine
+
+The Restack Engine uses Temporal to reliably run and manage AI workflows. It handles all the complex orchestration behind the scenes, including:
+
+- Long-running workflows that maintain state for days or months
+- Detailed workflow replay and debugging
+- Automated event processing and handling
+- Scheduled and recurring job execution 
+- Smart API rate limiting
+- Persistent memory and state management
+
+### Restack Web Interface
+
+The web-based dashboard lets you:
+
+- Track and troubleshoot running workflows
+- Step through and replay workflow executions
+- Test and validate individual functions
+- Create and manage workflow schedules
+- Access complete execution logs and history