convez.ai
PluginDesenvolvimento WebIntermediário
shogo-labs

Shogo AI Platform SDK

shogo-labs/shogo-ai

SDK sem boilerplate para apps agentic com auth e BD integrados

Ver no GitHub
BomPluginScore · de 0 a 100

SDK TypeScript zero-boilerplate para autenticação e banco de dados em aplicações Shogo. Oferece construtor de agentes orientado por chat, agentes persistentes e espaços de trabalho dinâmicos integrados numa plataforma completa com API Hono, runtimes e clientes multi-plataforma.

Instalação

$npx convez-ai shogo-labs/shogo-ai

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
20
Forks
16
Acompanhando
0
Saúde
87%
Último commit
há 1 dia
Versão
v2.5.3
Issues abertas
146
Contribuidores
36

Casos de uso

  • Construir aplicações conversacionais com agentes de IA persistentes
  • Implementar autenticação e camada de dados sem configuração manual
  • Desenvolver produtos agentic com runtimes cloud-native

Veredito

Solução madura e bem estruturada para quem quer construir apps agentic sem fricção. Modelo de licença híbrido (AGPL/MIT) oferece transparência; excelente cobertura de testes (84% backend) e documentação abrangem todos os componentes.

README

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

Shogo AI

Backend coverage

Frontend coverage

AI-first agent builder for chat-driven apps, persistent agents, and dynamic workspaces.

Website · Launch Studio · Documentation

Shogo combines a Hono API, Expo-based clients, agent runtimes, project runtimes, and a developer SDK into one platform for building and operating agentic products.

Open Source Model

Shogo uses a split-license model. AGPL-3.0-or-later guards the cloud-service surface a competitor would need to ship a hosted clone; everything else is MIT so adoption is friction-free.

  • AGPL-3.0-or-later: apps/api/, packages/agent-runtime/, packages/shared-runtime/
  • MIT: the @shogo-ai/* libraries, apps/mobile/, apps/desktop/, packages/shared-app/, packages/shared-ui/, packages/ui-kit/, packages/domain-stores/, templates/runtime-template/
  • CC BY 4.0: apps/docs/, docs/
  • Proprietary: terraform/, k8s/, deploy-examples/, .github/workflows/ (see INFRASTRUCTURE-LICENSE.md)
  • The hosted Shogo Cloud offering is proprietary

See docs/LICENSING.md for the full strategy and rationale, plus LICENSE, NOTICE, INFRASTRUCTURE-LICENSE.md, and TRADEMARK.md.

Repository Layout

License is shown inline so the AGPL/MIT boundary is visible at a glance.

PathLicensePurpose
apps/api/AGPLHono API server, auth, billing, runtime orchestration
apps/mobile/MITExpo app for web, iOS, and Android
apps/desktop/MITLocal desktop distribution
apps/docs/CC BY 4.0Documentation site
packages/sdk/MITClient SDK; back-compat shims for moved subpaths
packages/core/MITLogger, OTEL instrumentation, stream-buffer, chat-message
packages/agent/MITAgent loop, model router, hooks, pi-ai adapter
packages/db/MITPrisma adapter helpers (PG / SQLite / libSQL)
packages/email/MITTransactional email (SES / SMTP / OCI)
packages/voice/MITElevenLabs + Twilio voice infra; React + RN UI
packages/cli/MITvalidateManifest / runDeploy / pkg helpers
packages/shogo-worker/MITshogo-worker self-host CLI
packages/model-catalog/MITThin re-export shim (workspace-only)
packages/agent-runtime/AGPLAgent gateway, tools, integrations
packages/shared-runtime/AGPLServer-side glue (s3-sync, server framework)
packages/shared-app/MITShared app/domain logic
packages/shared-ui/MITShared UI components
packages/ui-kit/MITTheme and routing helpers
packages/domain-stores/MITDomain store layer
templates/runtime-template/MITProject template

Quick Start

Local development

Prerequisites:

  1. Install dependencies.
bun install
  1. Create your local env file.
cp .env.example .env.local
  1. Start local infrastructure.
bun run docker:infra
  1. Run database migrations.
bun run db:migrate:deploy
  1. Start the app.
bun run dev:all

Open http://localhost:8081.

Self-Hosting

Shogo can be self-hosted locally or on your own infrastructure. For setup details, required environment variables, storage, and deployment notes, see docs/SELF_HOSTING.md.

Local desktop/offline usage is documented in apps/desktop/README.md.

Packages

Published to npm (MIT, lockstep release on the sdk-v* tag):

PackageDescription
@shogo-ai/sdkClient SDK — auth, db client, LLM gateway, voice client
@shogo-ai/coreLogger, OTEL instrumentation, stream-buffer, chat-message
@shogo-ai/agentAgent loop, model catalog/router, hooks, pi-ai adapter
@shogo-ai/dbPrisma adapter helpers (PG / SQLite / libSQL)
@shogo-ai/emailTransactional email — SES / SMTP / OCI
@shogo-ai/voiceElevenLabs + Twilio voice; React + React Native UI
@shogo-ai/clivalidateManifest / runDeploy / pkg helpers

Old @shogo-ai/sdk/<subpath> imports keep working through deprecated re-export shims; see packages/sdk/MIGRATION.md.

Workspace-only (AGPL):

PackageDescription
@shogo/apiAPI server and platform orchestration
@shogo/agent-runtimeAgent runtime and tool gateway
@shogo/shared-runtimeServer-side glue used only by the AGPL surface above

Workspace-only (MIT):

PackageDescription
@shogo/mobilePrimary client app
shogoDesktop packaging layer
@shogo/shared-appShared app/domain logic
@shogo/shared-uiShared UI components
@shogo/ui-kitTheme and routing helpers
@shogo/domain-storesDomain store layer

Commands

CommandDescription
bun run dev:allStart API and web app
bun run dev:backendStart API only
bun run docker:infraStart Postgres, Redis, and MinIO
bun run db:migrate:deployApply migrations
bun run buildBuild the monorepo
bun run build:packagesBuild all 7 published @shogo-ai/* packages
bun run build:sdk / :core / :agent / :db / :email / :voice / :cliBuild a single package
bun run testRun tests
bun run typecheckRun TypeScript checks
bun run lintRun linters

Links

Community

  • CONTRIBUTING.md for contribution guidelines
  • CLA.md for contributor licensing terms
  • SECURITY.md for responsible disclosure
  • TRADEMARK.md for branding and name usage

Documentation

  • Getting Started -- quickstart guide
  • docs/GETTING_STARTED.md
  • docs/ARCHITECTURE.md
  • docs/SELF_HOSTING.md
  • packages/sdk/README.md
Ver o original no GitHub

Bom para

Relacionados