Verbally is a Laravel application that provides AI-powered English text correction with streaming, structured diffs, and follow-up actions like rewriting or generating short examples.

Stars

6

7-day growth

No data

Forks

1

Open issues

0

License

No data

Last updated

2026-07-29

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It demonstrates a practical, real-time AI integration using Laravel Livewire and the Gemini API, with robust session management, error handling, and a clean, reusable component structure.

Who it is for

  • English learners seeking detailed corrections
  • Writers wanting to improve their English texts
  • Laravel developers exploring AI streaming in web apps
  • Educators building interactive language tools

Use cases

  • Correcting essays or emails with real-time feedback
  • Learning from structured diff between original and corrected text
  • Requesting a natural rewrite or a short example after correction
  • Testing AI-powered features in a Laravel Livewire application

Strengths

  • Streaming correction with structured diff for clear comparison
  • Session-based rate limiting (20 corrections) prevents abuse
  • Comprehensive error handling for API timeouts, rate limits, and invalid responses
  • Modern stack: Laravel 13, Livewire 4, PHP 8.3, and Gemini API

Considerations

  • Only supports English and depends on a valid Gemini API key
  • Limited to 20 corrections per session
  • Requires specific environment setup and PHP 8.3+

README quick start

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.

Description

English corrections & coaching

Related repositories

Similar projects matched by category, topics, and programming language.

MoonshotAI
Featured
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 & Machine LearningAI Agents
3,348
lopopolo
Featured
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 & Machine LearningAI Agents
2,390
slvDev
Featured
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 & Machine LearningLarge Language Models
1,960