Skip to content

Joystickplays/palmirror

Repository files navigation

PalMirror

PalMirror is an opinionated, open-source chat client designed for creating, and interacting with characters. It provides a modern, private, and flexible alternative to similar AI chat platforms.

Try PalMirror through the demo.

Features

  • Character Chatting

    • AI chat optimized for roleplay chatting.
    • Employs transparent prompt injections for a greater experience.
  • PalMirror Experience — Proprietary character format)

    • Dynamic Status: Characters can update their status based on user interactions.
    • Invocations: Trigger small actions such as sound effects, speech snippets, or visuals.
  • PalMirror Secure

    • Encrypt chats locally.
    • API keys are stored encrypted, never as raw text.
    • Required for chat persistence—else everything will be ephemeral.
  • Compatibility

    • Supports importing characters from other platforms.
    • Optimized for mobile, but also usable on desktop.
  • User-First Design

    • Supercharged with animations and transitions.

Installation

Requirements

  • Node.js (v18 or higher recommended)
  • npm or yarn
  • Git

Setup

# Clone the repository
git clone https://github.com/Joystickplays/palmirror.git

cd palmirror

# Install dependencies
npm install

# Run development server
npm run dev

The app should now be accessible at http://localhost:3000.


Contributing

Contributions are welcome!

  1. Fork the repo
  2. Create a new branch (git checkout -b feature-xyz)
  3. Commit changes
  4. Open a Pull Request

License

PalMirror is released under the GPL-3.0 License.

About

Serverless AI platform

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published