Libra AI: um projeto de código aberto para criar e implantar rapidamente aplicativos da Web por meio de linguagem natural

A Libra AI é uma plataforma de desenvolvimento nativa de IA de código aberto projetada para permitir a rápida criação, iteração e implantação de aplicativos da Web por meio da interação de linguagem natural. Ela se baseia na arquitetura Cloudflare Workers, integra vários modelos de IA (por exemplo, Claude, OpenAI, Gemini e DeepSeek) e oferece suporte ao gerenciamento do ciclo de vida completo, desde a prototipagem até a implantação em ambientes de produção. Como V0 responder cantando Adorável Uma alternativa de código aberto ao Cloudflare, o Libra AI oferece funcionalidade pronta para uso em ambientes de produção, com ênfase na autonomia técnica e na colaboração da comunidade. Os usuários podem descrever os requisitos em frases simples, gerar código de alta qualidade e combiná-lo com a computação de borda da Cloudflare para uma implantação eficiente. A plataforma oferece suporte à personalização flexível e é adequada para desenvolvedores individuais, equipes empresariais e usuários que precisam de implementações privadas.

Lista de funções

• Geração de código orientada por IASuporte para integração de vários modelos (por exemplo, Claude, OpenAI), geração de código de nível de produção por meio de linguagem natural e adesão automática às práticas recomendadas.
• ambiente de desenvolvimento em nuvemCódigo de barras: fornece realce de código, indentação inteligente e visualização ao vivo (HMR) com suporte para plug-ins personalizados.
• integração de pilha completaConectividade perfeita com o GitHub, suporte para implantações de computação de borda da Cloudflare, autenticação OAuth 2.0 e gerenciamento de pagamentos Stripe.
• Implementação do ambiente de produçãoArquitetura sem servidor baseada no Cloudflare Workers com suporte para dimensionamento elástico, certificados TLS/SSL automatizados e reversão com um clique.
• Suporte a várias sandboxes: Integração E2B e Daytona, fornecendo um ambiente seguro para a execução de código.
• Documentação e suporte da comunidadeDocumentação técnica detalhada e fóruns da comunidade são fornecidos para dar suporte à internacionalização multilíngue.

Usando a Ajuda

Processo de instalação e implementação

O Libra AI oferece duas maneiras de usá-lo: serviço hospedado na nuvem e autoimplantação local. As diretrizes detalhadas de uso são fornecidas abaixo.

1. serviços de hospedagem na nuvem (recomendado)

Os serviços de hospedagem na nuvem são adequados para usuários que desejam acelerar o ritmo e começar a desenvolver sem configurações complexas.

• mover::
  1. Visite libra.dev para se registrar via GitHub OAuth ou e-mail.
  2. Uma vez conectado, vá para a interface principal e descreva os requisitos do aplicativo usando linguagem natural (por exemplo, "Criar um site de blog com login de usuário").
  3. O Libra AI gera automaticamente o código, fornecendo uma visualização ao vivo.
  4. Configure um nome de domínio personalizado (via Cloudflare para SaaS) e implemente no Cloudflare Workers com um único clique.
• advertência::
  • Certifique-se de que sua conexão de rede esteja estável para acessar a rede de borda da Cloudflare.
  • A configuração de pagamento do Stripe requer configurações adicionais para o gerenciamento de assinaturas comerciais; consulte a documentação do Stripe.

2. implantação de desenvolvimento local (para desenvolvedores)

A implementação local é adequada para usuários que precisam de personalização profunda ou implementação privada. Veja a seguir as etapas detalhadas:

Requisitos ambientais

Certifique-se de que o ambiente local atenda aos seguintes requisitos:

git --version  # >= 2.30.0
node --version # >= 20.0.0（推荐 24）
bun --version  # >= 1.0.0

Etapa 1: Obtenção do código-fonte

git clone https://github.com/nextify-limited/libra.git
cd libra
bun install
# 可选：为 web 应用生成国际化文件
cd apps/web && bun run prebuild && cd ../..

Etapa 2: Configurar as variáveis de ambiente

• Copie o arquivo de ambiente de exemplo e edite-o:

cp .env.example .env

• existir .env para configurar as variáveis de ambiente necessárias, como a chave da API do Cloudflare, as informações de conexão do banco de dados e a chave da API do modelo de IA (como o Claude (ou OpenAI). Consulte a documentação do projeto para obter variáveis específicas.

Etapa 3: inicializar o banco de dados

• Banco de dados mestre (PostgreSQL)::

cd packages/db
bun db:generate  # 生成迁移文件
bun db:migrate   # 执行迁移

• Banco de dados certificado (D1/SQLite)::

cd apps/web
bun wrangler d1 execute libra --local --command='SELECT 1'  # 测试连接
cd packages/auth
bun db:generate
bun db:migrate

Etapa 4: iniciar o serviço de desenvolvimento

• Inicie todos os serviços:

bun dev

• ou inicie o aplicativo principal separadamente:

cd apps/web && bun dev

Etapa 5: Configure o Stripe Payments (obrigatório para recursos comerciais)

• Execute um teste de webhook local do Stripe:

stripe listen --forward-to localhost:3000/api/auth/stripe/webhook

• Configure produtos e assinaturas no painel do Stripe, consulte a documentação do Stripe.

Etapa 6: Acesso a serviços locais

Depois que o serviço local for iniciado, ele poderá ser acessado no seguinte endereço:

• Aplicação principal:http://localhost:3000
• Site de documentação:http://localhost:3000/docs
• Serviço CDN:http://localhost:3000/cdn

3. implantação do ambiente de produção

• Implementação de hospedagem em nuvem::
  1. Desenvolvimento completo de aplicativos na plataforma libra.dev.
  2. Configure um nome de domínio personalizado e um certificado SSL (via Cloudflare para SaaS).
  3. Clique no botão Deploy e a plataforma publicará automaticamente o aplicativo no Cloudflare Workers.
• Implementação auto-hospedada::
  1. Implemente cada serviço usando o fluxo de trabalho do GitHub Actions, consulte a documentação a seguir:
     • .github/workflows/web.ymlImplementação do aplicativo mestre
     • .github/workflows/cdn.ymlImplementação do serviço CDN
     • .github/workflows/deploy.ymlServiços de implantação
     • .github/workflows/dispatcher.ymlServiços de roteamento
     • .github/workflows/screenshot.yml: Serviço de captura de tela
     • .github/workflows/docs.yml: Site de documentação
  2. Certifique-se de que o Cloudflare Workers e o Wrangler CLI estejam configurados.
  3. Execute o comando de implantação:

bun wrangler deploy

4. Configurar o roteamento do projeto do usuário (via apps/dispatcher serviços).

Funções principais

• Geração de código de IA::
  1. Insira uma descrição em linguagem natural (por exemplo, "Build an e-commerce website that supports product display and payment") na interface principal.
  2. O Libra AI chama o modelo integrado (padrão Claude ou OpenAI) para gerar o código.
  3. Visualize o código gerado e verifique a segurança do tipo TypeScript e a estrutura do código.
  4. O código pode ser editado manualmente ou os componentes da interface do usuário podem ser ajustados por meio da interface (com base no shadcn/ui).
• Visualização e edição ao vivo::
  • Aproveite o destaque de código e o preenchimento inteligente com o IDE em nuvem integrado.
  • A visualização ao vivo é obtida pelo HMR (Hot Module Replacement), que permite que a página seja atualizada instantaneamente após alterações no código.
  • A análise de dependência é feita automaticamente com a execução de bun install Instale os pacotes necessários.
• Implementação do projeto::
  1. Selecione o destino da implementação (domínio personalizado ou endereço de trabalho padrão).
  2. O sistema processa as tarefas de implementação de forma assíncrona por meio do Cloudflare Queues (arquitetura V2).
  3. Quando a implementação estiver concluída, verifique os registros e o status e use a reversão com um clique, se necessário.
• Autenticação e pagamento::
  • aprovar (um projeto de lei ou inspeção etc.) apps/auth-studio Configure a autenticação do usuário (compatível com OAuth 2.0).
  • Faça a integração com o Stripe para o gerenciamento de assinaturas e configure um webhook para receber eventos de pagamento.

advertência

• Configuração do modelo de IA: As chaves de API do modelo de IA precisam ser configuradas manualmente para implantações locais (consulte o packages/sandbox (Documentação).
• gerenciamento de direitosVerifique se os direitos do usuário estão configurados corretamente para impedir o acesso não autorizado.
• Tratamento de errosQuando a implementação falhar, verifique se há filas de letras mortas nas filas do Cloudflare e tente novamente com referência aos registros.

cenário do aplicativo

1. Prototipagem rápida
   • Descrição da cena: As startups precisam validar ideias de produtos rapidamente. Os desenvolvedores usam o Libra AI para inserir uma descrição dos requisitos, gerar um protótipo com interface de front-end e lógica de back-end e implantá-lo em minutos para mostrar aos clientes ou investidores.
2. Desenvolvimento de aplicativos Web corporativos
   • Descrição da cenaO Libra AI fornece autenticação OAuth segura, suporte a banco de dados PostgreSQL e implantação de borda do Cloudflare para garantir alta disponibilidade e segurança de dados.
3. Educação e aprendizado
   • Descrição da cenaProgramação: iniciantes em programação aprendem desenvolvimento web com o serviço hospedado na nuvem da Libra AI. Gere código digitando uma descrição simples e comece a trabalhar rapidamente com a documentação e o suporte da comunidade.
4. Desenvolvimento de projetos de código aberto
   • Descrição da cenaOs desenvolvedores personalizam a funcionalidade proprietária com base na versão de código aberto do Libra e implementam em nuvens privadas para atender a necessidades regionais ou de conformidade específicas.

QA

1. Quais modelos de IA são compatíveis com o Libra AI?
   • Claude, OpenAI, Gemini e DeepSeek são compatíveis, e os desenvolvedores podem configurar outros modelos por meio de APIs.
2. Qual é a diferença entre a hospedagem na nuvem e as versões de código aberto?
   • A hospedagem na nuvem oferece uma experiência pronta para uso com suporte e funcionalidade completos de IA; a versão de código aberto exige a autoconfiguração da IA e do ambiente, mas oferece suporte à personalização profunda e à privatização de dados.
3. Como posso garantir a qualidade do código gerado?
   • O Libra AI segue o TypeScript, moderno e seguro para o tipo Reagir Design responsivo CSS Patterns e Tailwind, gerando código otimizado para ambientes de produção.
4. Ele é compatível com o uso comercial?
   • Sim, a Cloud Hosting oferece um modelo de pagamento conforme o uso com uma versão de código aberto que segue a licença AGPL-3.0 para projetos derivados de código aberto, ou uma licença comercial que pode ser adquirida para desenvolvimento de código fechado.
5. Como posso me envolver em contribuições para a comunidade?
   • Você pode enviar código, melhorar a documentação, relatar problemas ou traduzir vários idiomas via GitHub, conforme descrito nas Diretrizes de contribuição da comunidade.