Feedback, issues, or gripes? Just want to hang out? Hit us up on the CardShark Discord.
CardShark is a PNG metadata editor and AI chatbot frontend built exclusively by AI assistants. It's designed for interactive storytelling and character-driven chat experiences.
- Dynamic Chat System: Real-time streaming conversations with multiple AI providers (OpenAI, Claude, KoboldCPP, etc.)
- Impersonation Mode: Let the AI generate responses on your behalf with a single click
- Chat Forking: Branch conversations from any message to explore alternative storylines
- Message Regeneration: Regenerate AI responses to explore different narrative directions
CardShark offers 4 powerful options for managing conversation context:
- Session Notes: Persistent notes that stay active across the entire chat session
- Author's Note (Journaling): Inject dynamic guidance into the conversation context
- Automatic Compression: Intelligent message summarization to maintain coherent long conversations
- Context Window Monitoring: Real-time visibility into what's being sent to the AI
- World Cards System: Create immersive worlds with dynamic maps and locations
- World Builder: Design rich environments with interconnected locations and characters
- World Play Mode: Navigate maps, interact with AI-driven characters, and experience dynamic events
- Combat Cards (in development): Structured combat encounters and game mechanics
- Character Management: Create and manage AI characters with rich metadata embedded in PNG files
- Persistent Identity: UUID-based character tracking ensures consistency across sessions
- Template Management: Customizable prompt templates for different conversation styles
- Lore System: Build deep character backgrounds with searchable, context-aware lore injection
- Content Filtering: Advanced moderation and safety controls with built-in and custom filters
- Comprehensive Persistence: Robust data storage with atomic operations and error recovery
- Rich Media Support: Background images, character portraits, and visual elements
- Room Management: Create and manage different conversation spaces and contexts
For development details, see CONTEXT.md.
- Download the latest release (
.exefor Windows) - Run the executable
- Configure your AI provider in Settings
- Start chatting!
Quick version:
# Clone and run development servers
python start.py
# Backend at http://localhost:9696
# Frontend at http://localhost:6969This project was previously released under the AGPL. Current development and releases are proprietary.
Built with ❤️ by AI assistants for the AI character community.