AI-powered character generator built with React, addressing the need for detailed character creation for writers, game developers, and role-playing enthusiasts. It leverages multiple Large Language Models (LLMs) to generate rich character profiles, NPC system prompts for AI roleplaying, and visual tags for image generation, offering a flexible and comprehensive tool for creative endeavors.

How It Works

This project utilizes React for its frontend, integrating with a variety of LLMs including Google Gemini, OpenAI, Anthropic Claude, various Chinese LLMs, and local models via Ollama. It offers two generation modes: "Custom Mode" for precise control over world settings and keywords, and "Random Mode" for spontaneous inspiration. The core generation process produces detailed basic profiles, psychological assessments, appearance descriptions, and background stories, alongside specialized outputs like NPC system prompts and visual studio prompts for image generation tools.

Quick Start & Requirements

• Online Access: A live demo is available at https://karmacoke.github.io/chargen/.
• Local Setup:
  • Prerequisites: Node.js (LTS recommended) and Git.
  • Installation: Clone the repository (git clone https://github.com/Karmacoke/chargen.git), navigate to the directory (cd my-chargen), install dependencies (npm install), and start the application (npm start).
  • Access: The application will launch at http://localhost:3000.
• Configuration: Requires users to configure API keys for their chosen LLM provider (Gemini, OpenAI, Claude, Chinese LLMs) or set up a local Ollama instance.

Highlighted Details

• Multi-Model Support: Integrates natively with Google Gemini, OpenAI (e.g., gpt-4o), Anthropic Claude (e.g., claude-3.5-sonnet), various Chinese LLMs, and local models via Ollama, offering significant LLM flexibility.
• Advanced Character Generation: Produces in-depth profiles covering basic, psychological, appearance, and background story elements.
• Specialized Outputs: Automatically generates NPC system prompts for AI roleplaying and English image prompts compatible with Stable Diffusion or Midjourney across six professional visual types.
• Anti-Cliché System: Features five levels of character design styles, from "Ordinary" to "Extreme Rebel," enabling nuanced and unconventional character creation.
• World Setting Templates: Includes presets for popular genres like Fantasy, Cyberpunk, Space Opera, and Lovecraftian Horror, alongside custom options.
• Multi-Language & Theming: Supports 7 languages and offers both light and dark modes.

Maintenance & Community

The project welcomes contributions via GitHub Issues and Pull Requests. Further community interaction channels like Discord or Slack are not explicitly mentioned.

Licensing & Compatibility

This project is released under the MIT License, permitting free use, modification, and distribution, including for commercial applications.

Limitations & Caveats

Functionality is dependent on users providing their own API keys for external LLM services, which may incur usage costs. Running local LLMs requires separate setup and potentially substantial hardware resources. The project relies on external LLM APIs, so performance and availability are subject to those services.