convez.ai
PluginDesenvolvimento WebIntermediário
PMDevSolutions

Claudius - Widget de Chat IA Embarcável

PMDevSolutions/Claudius

Widget de chat Claude embarcável em qualquer site com uma linha de código

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin open-source que oferece um widget de chat IA baseado em Claude, pronto para ser embutido em qualquer website com uma única tag script. Combina React + TypeScript no frontend com Cloudflare Workers no backend para manter a chave da API segura. Suporta instalação como componente React ou embed direto via CDN.

Instalação

$npx convez-ai PMDevSolutions/Claudius

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
1
Saúde
87%
Último commit
há 3 dias
Versão
v1.18.0
Issues abertas
25
Contribuidores
3

Casos de uso

  • Adicionar suporte por chat IA em websites existentes
  • Criar assistentes personalizados para aplicações React/Next.js
  • Implementar atendimento ao cliente 24/7 com IA
  • Embeds de chat temáticos em landing pages e documentação

Veredito

Claudius é uma solução prática e bem-documentada para integrar chat de IA em websites sem complexidade. A arquitetura com Cloudflare Workers resolve elegantemente o problema de manter chaves de API seguras, e o suporte tanto a embed simples quanto a componentes React oferece flexibilidade real para diferentes casos de uso.

README

A tradução para o português deste README ainda está na fila.

Claudius - Embeddable AI Chat Widget

npm create-claudius license

An open-source, embeddable AI chat widget powered by Claude. Drop it into any website with a single script tag, or install it as a React component.

Full documentation: claudius-docs.pages.dev

Try it live at pmds.info or on the docs home page.

Quick start

Claudius is two pieces: a Cloudflare Worker (keeps your Anthropic API key server-side) and a widget embed.

Fastest: scaffold a project

npm create claudius@latest

Answer a few prompts (framework — vanilla, React, or Next.js — theme, accent color, worker API URL, and optionally a Cloudflare Worker) and you get a ready-to-run project. See the scaffolding guide.

Prefer to wire things up by hand? Continue below.

1. Deploy the worker

git clone https://github.com/PMDevSolutions/Claudius.git
cd Claudius/worker
pnpm install
npx wrangler login
npx wrangler kv namespace create RATE_LIMIT   # paste the id into wrangler.toml
npx wrangler secret put ANTHROPIC_API_KEY
npx wrangler deploy

Then set ALLOWED_ORIGIN to your site's origin (Workers → Settings → Variables). Comma-separate multiple origins.

2. Embed the widget

Add before </body>:

<script>
  window.ClaudiusConfig = {
    apiUrl: "https://claudius-chat-worker.<you>.workers.dev",
    title: "Support",
    subtitle: "Ask me anything",
    theme: "auto",
  };
</script>
<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/gh/PMDevSolutions/Claudius@1/cdn/claudius.css"
/>
<script src="https://cdn.jsdelivr.net/gh/PMDevSolutions/Claudius@1/cdn/claudius.iife.js"></script>

The @1 CDN channel auto-updates within v1.x. That's it.

3. Or install as a React component

Building a React app? Install from npm instead of the script embed:

npm install claudius-chat-widget react react-dom
import { ChatWidget } from "claudius-chat-widget";
import "claudius-chat-widget/style.css";

<ChatWidget
  apiUrl="https://claudius-chat-worker.<you>.workers.dev"
  title="Support"
/>;

The package ships dual ESM/CJS builds with TypeScript types. See the documentation for theming, localization, and SSR notes.

Documentation

SectionWhat's there
Getting startedArchitecture, quick start, local development
ConfigurationEvery widget and worker option, triggers, localization, theming, multi-client configs
DeploymentWorker setup, CDN vs self-hosted embed, per-host guides (static, WordPress, Replit, React/Next.js)
API referenceREST endpoints, error codes, widget TypeScript API
Migration guidesUpgrading between versions
FAQCORS, rate limits, CSP, privacy

Development

cd worker && pnpm install && pnpm dev    # http://localhost:8787
cd widget && pnpm install && pnpm dev    # http://localhost:5173

Tests: pnpm test in widget/ and worker/. Details in the local development guide.

Tech stack

React 18 + TypeScript + Tailwind (widget) · Cloudflare Workers + Hono + Anthropic SDK (worker) · Claude Haiku 4.5 by default.

Contributing

Contributions are welcome — see CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md for how to report security issues responsibly.

License

Released under the MIT License.

Ver o original no GitHub

Bom para

Relacionados