Verbally 是一个基于 Laravel 的应用,利用 AI 进行英语文本纠错,支持流式输出、结构化差异对比以及改写或生成短示例等后续操作。

Stars

8

7 天增长

暂无数据

Fork 数

2

开放 Issue

0

开源协议

暂无数据

最近更新

2026-07-29

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

该项目展示了如何通过 Laravel Livewire 和 Gemini API 实现实用的实时 AI 集成,具备稳健的会话管理、错误处理以及清晰的组件结构。

适合谁使用

  • 寻求详细纠错的英语学习者
  • 希望改进英语文本的写作者
  • 探索在 Web 应用中集成 AI 流式输出的 Laravel 开发者
  • 构建交互式语言工具的教育工作者

典型使用场景

  • 实时反馈纠正论文或邮件
  • 通过结构化差异对比分析原文与纠错后的区别
  • 在纠错后请求自然改写或简短示例
  • 在 Laravel Livewire 应用中测试 AI 功能

项目优势

  • 流式纠错与结构化差异对比,便于比较
  • 基于会话的速率限制(20 次纠错)防止滥用
  • 全面的错误处理,涵盖 API 超时、速率限制和无效响应
  • 现代技术栈:Laravel 13、Livewire 4、PHP 8.3 和 Gemini API

使用前须知

  • 仅支持英语,且依赖有效的 Gemini API 密钥
  • 每个会话仅限 20 次纠错
  • 需要特定环境配置及 PHP 8.3 或更高版本

README 快速开始

Verbally

Verbally é uma aplicação Laravel para correção de inglês com apoio de IA. A interface principal fica na página inicial e permite enviar um texto, receber a correção em streaming, ver detalhes estruturados da revisão e pedir seguimentos como reescrita natural ou um exemplo curto.

Funcionalidades

  • Correção de texto em inglês com streaming.
  • Exibição de detalhes da correção com diff estruturado.
  • Ações de acompanhamento:
    • reescrita natural;
    • exemplo curto relacionado à correção.
  • Bloqueio de sessão enquanto uma operação está em andamento.
  • Limite de 20 correções concluídas por sessão.
  • Tratamento de erros recuperáveis, incluindo falta de configuração, timeout, limite de taxa e respostas inválidas do provedor.

Captura

Requisitos

  • PHP ^8.3
  • Composer
  • Node.js e npm
  • Laravel 13
  • Livewire 4
  • Uma configuração válida do provedor Gemini usada pelas ações de IA do projeto

Configuração

O projeto lê as seguintes variáveis de ambiente relacionadas à IA no .env:

GEMINI_API_KEY=AQ.XXXXXXXXXXXXXXXXXXXXXXX # https://aistudio.google.com/api-keys
VERBALLY_GEMINI_MODEL=gemini-flash-latest # Modelo desejado
VERBALLY_AI_TIMEOUT_SECONDS=120 # timeout

Instalação

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm install

Desenvolvimento

O composer.json já expõe os comandos principais do projeto:

composer run setup
composer run dev
composer test

O comando composer run dev sobe a aplicação com servidor, fila, logs e Vite em paralelo.

Testes

composer test

Os testes cobrem a rota inicial, a lógica das ações de IA e o fluxo de browser da interface.

Estrutura relevante

  • routes/web.php: rota principal da aplicação.
  • app/Actions/GenerateCorrection.php: gera a correção em streaming e valida os detalhes estruturados.
  • app/Actions/GenerateFollowUp.php: gera os seguimentos de reescrita e exemplo.
  • app/Ai/: agentes, prompts e runtime de IA.
  • resources/views/pages/index/: página principal Livewire da aplicação.
  • resources/views/components/: componentes reutilizáveis da interface.
  • tests/Feature/: testes das ações e da rota.
  • tests/Browser/: fluxo end-to-end da interface.

Licença

MIT. O repositório declara license: "MIT" em composer.json.

项目描述

English corrections & coaching

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

MoonshotAI
精选
MoonshotAI GitHub avatar

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI 与机器学习AI 智能体
3,348
lopopolo
精选
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI 与机器学习AI 智能体
2,390
slvDev
精选
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI 与机器学习大语言模型
1,960