SDKs e CLI
Instale os pacotes oficiais @luaward/sdk, luaward (Python) e @luaward/cli via npm e PyPI e veja qual token cada um usa.
Confira os pacotes oficiais antes de instalar
Instale apenas pelos links oficiais abaixo e por github.com/luaward. Observe o tipo de credencial: os SDKs usam uma Developer API key do workspace (lwa_live_...), enquanto a CLI usa um Personal token (lwm_...).
Pacotes oficiais
| Ferramenta | Registro e pacote | Autenticação | Requisitos |
|---|---|---|---|
| SDK JavaScript / TypeScript | npm @luaward/sdk | Developer API key (lwa_live_...) | Node.js / fetch padrão |
| SDK Python | PyPI luaward | Developer API key (lwa_live_...) | Python 3.10+, zero dependências externas |
| Luaward CLI | npm @luaward/cli | Personal token (lwm_...) | Node.js 20+ |
| GitHub oficial | github.com/luaward | Repositórios e documentação | Organização oficial |
SDK JavaScript / TypeScript (@luaward/sdk)
Instale pelo npm:
npm install @luaward/sdkInicialize o LuawardClient no servidor usando sua Developer API key (lwa_live_...) e o ID do projeto:
import { LuawardClient } from "@luaward/sdk";
const lw = new LuawardClient({
apiKey: process.env.LUAWARD_API_KEY,
projectId: process.env.LUAWARD_PROJECT_ID,
});
const created = await lw.keys.create({
discord_id: "123456789012345678",
key_days: 30,
note: "Monthly access",
});
const queued = await lw.scripts.upload(process.env.LUAWARD_SCRIPT_ID, {
source: 'print("Hello from SDK")',
preset: "balanced",
});- URL base: O padrão é
https://api.luaward.com, com/v3adicionado automaticamente. - Recursos incluídos:
projects,keys,scripts,stats,lw.request()genérico eLuarmorCompat(compare os campos antes de migrar). - Novas tentativas e erros: Repete respostas HTTP
429e503até 3 vezes respeitandoRetry-Aftere lança classes tipadas (LuawardAuthError,LuawardRateLimitError,LuawardPlanLimitError,LuawardNotFoundError,LuawardError).
Veja os scopes e endpoints completos em Visão geral da API e Referência da API v3.
SDK Python (luaward)
Instale pelo PyPI:
pip install luawardUse LuawardClient em scripts síncronos ou AsyncLuawardClient em fluxos assíncronos:
import os
from luaward import LuawardClient
lw = LuawardClient(
api_key=os.environ["LUAWARD_API_KEY"],
project_id=os.environ["LUAWARD_PROJECT_ID"],
)
created = lw.keys.create(
discord_id="123456789012345678",
key_days=30,
note="Monthly access",
)
print(created["user_key"])- Zero dependências externas: Usa
urllibda biblioteca padrão (requer Python 3.10+).AsyncLuawardClientexecuta chamadas usandoasyncio.to_thread(). - Cobertura: O cliente síncrono oferece
keys,scripts,statserequest(), enquanto o cliente assíncrono oferecekeyserequest(). IncluiLuarmorCompateAsyncLuarmorCompat. - Novas tentativas e exceções: Repete HTTP
429e503até 3 vezes e usa exceções tipadas emluaward.exceptions.
Luaward CLI (@luaward/cli)
Instale globalmente pelo npm (requer Node.js 20+):
npm install -g @luaward/cli
luaward --versionOu instale pelo tarball oficial em luaward.com:
npm install -g https://luaward.com/luaward-cli.tgz
luaward --version- Credenciais e Early Access: Autentica com um Personal token (
lwm_...) emhttps://luaward.com/api/ide(chaveslwa_live_...não funcionam na CLI). O acesso ao painel e ao IDE API está em Early Access. - Armazenamento local: Salvo em
~/.config/luaward/credentials.json(altere comLUAWARD_CONFIG_DIR) ou enviado viaLUAWARD_TOKEN. - Comandos principais:
login,init,scripts,pull,push,toggle,sessions,pair,dev,exec,stop,keyseerrors, todos compatíveis com--json/-jpara CI.
IDE, IA e MCP
- Extensão para VS Code / Cursor: Ainda não está publicada no VS Code Marketplace ou Open VSX. Fale com o suporte para solicitar um pacote
.vsixtestado durante o Early Access. - IA e MCP: Conecte Claude, ChatGPT, Claude Code ou Cursor às suas sessões de teste e scripts seguindo Workspace MCP.