Create Powerful AI Agents using local or remote AIs
Build collaborative AI agents that work together, handle payments, and automate complex workflows
Shinkai is a free, open-source platform that democratizes AI agent creation.
No coding required β just drag, drop, and deploy intelligent agents that can work across platforms and handle real-world tasks.
Features β’ Demo β’ Examples β’ Quick Start β’ Development β’ Documentation
π― No-Code Agent Builder β Create specialized AI agents in minutes through an intuitive visual interface. No programming experience needed.
π€ Multi-Agent Orchestration β Deploy teams of agents that collaborate, share context, and coordinate complex multi-step workflows automatically.
π° Crypto-Native Architecture β Built-in support for decentralized payments, DeFi interactions, and autonomous economic agents that can transact independently.
π Universal Protocol Support β Seamlessly integrates with Model Context Protocol (MCP), making your agents compatible with Claude, Cursor, and the broader AI ecosystem.
β‘ Hybrid Deployment β Run everything locally for maximum privacy, connect to cloud models for enhanced capabilities, or combine both approaches as needed.
π Security-First Design β Your crypto keys, sensitive data, and computations remain under your control with local-first architecture.
π Cross-Platform Compatibility β Works on Windows, macOS, and Linux with consistent performance and user experience.
shinkai-demo.mp4
Watch Shinkai agents collaborate to analyze market data, execute trades, and manage complex workflows autonomously.
πΉ Autonomous Trading Bot β Deploy an agent that monitors social sentiment, analyzes market trends, and executes trades based on predefined strategies.
π§ Intelligent Email Assistant β Create an agent that categorizes incoming emails, drafts contextual responses, and automatically schedules follow-ups.
π Data Intelligence Agent β Build agents that scrape web data, perform trend analysis, and generate comprehensive reports with actionable insights.
π Workflow Automation Hub β Orchestrate multiple specialized agents that handle different components of complex business processes seamlessly.
π¦ DeFi Portfolio Manager β Set up agents that monitor your crypto investments, rebalance portfolios, and execute yield farming strategies.
- Download the latest release for your platform from our releases page
- Install and launch Shinkai
- Create your first AI agent using our step-by-step guided interface
- Memory: 4GB RAM minimum (8GB recommended)
- Storage: 2GB free space
- OS: Windows 10+, macOS 10.15+, or Linux (Ubuntu 20.04+)
Shinkai is built as a modern monorepo using NX for orchestration and dependency management. The architecture consists of:
Core Applications:
- shinkai-desktop β Cross-platform Tauri application with React frontend
Shared Libraries:
- shinkai-message-ts β Message protocols and network communication with Shinkai Node
- shinkai-node-state β React Query-based state management for node data
- shinkai-ui β Reusable React components with design system
- shinkai-artifacts β Styled UI primitives built on Radix and Tailwind CSS
- shinkai-i18n β Internationalization utilities powered by i18next
Technology Stack:
- Frontend: React 18, TypeScript, Tailwind CSS, Radix UI
- Desktop: Tauri (Rust + React)
- State Management: Zustand (UI state) + React Query (server state)
- Build System: Vite, NX monorepo
- Testing: Vitest, React Testing Library
git clone https://github.com/dcSpark/shinkai-apps
cd shinkai-apps
nvm use
npm ci
Before running Shinkai, you'll need to download the embedded Shinkai Node binary that powers the application's core functionality. This can be done with a single command based on your platform:
macOS (Apple Silicon):
ARCH="aarch64-apple-darwin" \
SHINKAI_NODE_VERSION="v1.1.0" \
OLLAMA_VERSION="v0.7.1" \
npx ts-node ./ci-scripts/download-side-binaries.ts
Linux:
ARCH="x86_64-unknown-linux-gnu" \
OLLAMA_VERSION="v0.7.1" \
SHINKAI_NODE_VERSION="v1.1.0" \
npx ts-node ./ci-scripts/download-side-binaries.ts
Windows:
$ENV:OLLAMA_VERSION="v0.7.1"
$ENV:SHINKAI_NODE_VERSION="v1.1.0"
$ENV:ARCH="x86_64-pc-windows-msvc"
npx ts-node ./ci-scripts/download-side-binaries.ts
# Run desktop app (recommended for development)
npx nx serve:tauri shinkai-desktop
# Build desktop application
npx nx build shinkai-desktop
# Create development build
NODE_OPTIONS="--max_old_space_size=8192" npx nx build shinkai-desktop --config="./src-tauri/tauri.conf.development.json"
# Build all projects
npx nx run-many --target=build
# Update the built-in Ollama models repository. This repository contains model definitions, tags and metadata for all supported AI models. The command below regenerates the repository files to ensure compatibility with the latest Ollama version and model updates
npx ts-node ./ci-scripts/generate-ollama-models-repository.ts
# Generate Composio apps repository - This script regenerates the repository of pre-built Composio apps and templates that users can import into Shinkai. It ensures the app catalog stays up-to-date with the latest official releases.
deno run -A ./ci-scripts/composio-repository/main.ts
# Generate translations for all languages (EN, ES, etc.)
# This command uses AI to automatically generate translations for all supported languages based on the primary i18n source file (English).
# It ensures consistent translations across the entire application while maintaining natural language quality.
npx nx run shinkai-i18n:i18n
# Run tests
npx nx test [project-name]
npx nx run-many --target=test
# Lint code
npx nx lint [project-name]
npx nx run-many --target=lint
shinkai-apps/
βββ apps/
β βββ shinkai-desktop/ # Main desktop application
βββ libs/
β βββ shinkai-message-ts/ # Core messaging protocol
β βββ shinkai-node-state/ # State management
β βββ shinkai-ui/ # Component library
β βββ shinkai-artifacts/ # UI primitives
β βββ shinkai-i18n/ # Internationalization
βββ ci-scripts/ # Build and deployment scripts
βββ tools/ # Development utilities
Component Libraries:
- Radix UI β Unstyled, accessible component primitives
- Tailwind CSS β Utility-first styling and responsive design
- Shadcn/ui β Pre-built component patterns
State Management:
- Zustand β Client-side UI state management
- React Query β Server state, caching, and synchronization
Shinkai supports multiple languages through our i18n system:
# Add new translation keys
# Edit files in libs/shinkai-i18n/locales/
# Generate updated translation types
npx nx run shinkai-i18n:i18n
# Supported languages: en-US, es-ES, zh-CN, ja-JP, id-ID, tr-TR
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature
- Commit your changes:
git commit -m 'Add amazing feature'
- Push to the branch:
git push origin feature/amazing-feature
- Open a Pull Request
- Official Documentation β Comprehensive guides and API reference
- Discord Community β Get help and connect with other developers
- Twitter Updates β Latest news and announcements
Built with β€οΈ by the Shinkai community
Apache License β’
Report Bug β’
Request Feature