Assistente IA com NL2SQL para FastAPI
mixuechu/ai-assistant-setup
Integra NL2SQL em FastAPI com um comando
Ver no GitHubSkill para Claude que integra automaticamente um assistente de IA com capacidade NL2SQL em sistemas FastAPI + SQLAlchemy. Analisa schemas de banco, gera adaptadores, cria rotas no backend e componentes no frontend React, permitindo usuários consultarem dados via linguagem natural.
Instalação
npx convez-ai mixuechu/ai-assistant-setup1 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
Casos de uso
- Adicionar busca conversacional em bancos de dados existentes
- Criar chatbots que consultam dados sem escrever SQL manualmente
- Automatizar geração de rotas de IA em APIs FastAPI
Veredito

Ferramenta sólida para acelerar integração de IA conversacional em stacks FastAPI/SQLAlchemy. Requer Python 3.10+, dependências específicas (FastAPI, SQLAlchemy async, JWT) e pelo menos uma chave LLM; vale a pena para quem quer NL2SQL com proteções de segurança (validação SQL, whitelist de tabelas).
README
A tradução para o português deste README ainda está na fila.
ai-assistant-setup
Claude Code Skill — 一键为 FastAPI + SQLAlchemy 系统集成 NL2SQL AI 助手。
它做什么
运行 /ai-assistant-setup 后,Claude 会自动:
- 分析你的数据库 models,提取 schema
- Clone ai-assistant-engine
- 生成适配器代码(认证、SQL 执行、Schema 描述)
- 在你的后端创建 AI 路由
- 在你的前端添加 AI 聊天组件
- 配置依赖和环境变量
完成后,你的系统就拥有了一个带 NL2SQL 的 AI 助手 — 用户可以用自然语言查询数据库。
要求
- Python 3.10+
- FastAPI + SQLAlchemy (async) + JWT 认证
- 前端 React + TypeScript(可选,没有则跳过前端集成)
- 至少一个 LLM API key(DeepSeek / Claude / OpenAI)
安装
在 Claude Code 中:
/plugin marketplace add mixuechu/ai-assistant-setup
/plugin install ai-assistant-setup
或者手动:
git clone https://github.com/mixuechu/ai-assistant-setup.git ~/.claude/skills/ai-assistant-setup
使用
在你的 FastAPI 项目目录中,对 Claude 说:
/ai-assistant-setup
或者直接说"帮我集成 AI 助手"、"给系统加个 AI"。
支持的 LLM
| Provider | 环境变量 | 模型 |
|---|---|---|
| DeepSeek | DEEPSEEK_API_KEY | deepseek-chat |
| Claude (API) | ANTHROPIC_API_KEY | claude-sonnet-4-6 |
| Claude (Vertex AI) | GOOGLE_CLOUD_PROJECT | claude-sonnet-4-6 |
| OpenAI | OPENAI_API_KEY | gpt-4o |
安全
NL2SQL 三层防护:
- System Prompt — 指导 LLM 只写 SELECT
- SqlValidator — SELECT-only + 表白名单 + 自动 LIMIT + 多语句拒绝
- 数据库 — 建议生产环境用只读连接
敏感表(含 password/secret/token/permission 字段的表)自动排除。
License
MIT