Oracle, da instalação
à inteligência.
Uma conta Oracle com US$ 300 por equipe. Use OpenCode, Pi ou Devin para construir o app e escolha os serviços OCI que ajudam seu desafio. Nemotron no Compute é uma alternativa ao GenAI gerenciado.

Materiais complementares: curadoria do Carlão e referências do César
Seu caminho na OCI.
Confirme conta, crédito e região
Cada equipe terá sua própria conta com US$ 300. Confira saldo, validade, região e limites no console Oracle.
Prepare o servidor
O script da VPS cria a rede e a instância. O instalador prepara as ferramentas.
Ligue a inteligência
Programe com OpenCode, Pi ou Devin CLI. Para a IA do app, use Nemotron em Compute ou GenAI com acesso confirmado.
Acrescente o que o desafio precisa
OCR, transcrição, banco, arquivos ou painéis: escolha as peças no catálogo abaixo.
Skills de OCI para o seu agente.
OCI Agent Skills é um pacote aberto (Apache-2.0) da Jazz Automations, de quem mantém este site: 37 skills de OCI e Oracle Database, um catálogo pesquisável da CLI e 15 ferramentas MCP somente leitura. Com ele, o agente para de chutar comando oci: confere o escopo, diagnostica e só depois propõe a mudança, com o plano para revisão. Funciona com OpenCode, Claude Code, Codex, Gemini CLI e Cursor.
Projeto independente da comunidade, sem vínculo com a Oracle, em versão preview. É opcional: a stack do hackathon continua livre.
Instalar em dois minutos
O bloco instala o uv se faltar, baixa o pacote, copia as skills para uma pasta de trabalho e roda um teste offline. Testado em Ubuntu 24.04 limpo com OpenCode 1.18.30; o uv baixa o Python necessário sozinho. Não precisa de credencial para instalar.
(
set -e
command -v uv >/dev/null || curl -LsSf https://astral.sh/uv/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
git clone --depth 1 https://github.com/jazzautomations/oci-agent-skills.git "$HOME/oci-agent-skills"
bash "$HOME/oci-agent-skills/installers/install.sh" --target "$HOME/oci-skills" --host opencode --copy-shared --i-accept-unguarded
uv sync --frozen --project "$HOME/oci-skills/runtime"
uv run --frozen --project "$HOME/oci-skills/runtime" oci-readonly-smoke
)
cd "$HOME/oci-skills" && opencodeAbra o OpenCode dentro de ~/oci-skills para as tarefas de nuvem e peça em português, do jeito que você falaria: “a porta 3000 está liberada na security list, mas a demo não abre de fora”.
(
set -e
command -v uv >/dev/null || curl -LsSf https://astral.sh/uv/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
git clone --depth 1 https://github.com/jazzautomations/oci-agent-skills.git "$HOME/oci-agent-skills"
uv sync --frozen --project "$HOME/oci-agent-skills/runtime"
)
claude --plugin-dir "$HOME/oci-agent-skills"Onde ela ajuda nos desafios
| Quando a equipe travar em… | Skill | O que ela faz |
|---|---|---|
| “NotAuthorizedOrNotFound em tudo” | oci-cli-auth | Descobre com qual identidade, perfil e região a CLI está autenticando. |
| “Out of host capacity” ou limite estourado | oci-support-limits · oci-compute | Separa limite de serviço, quota e falta de capacidade; ajuda a escolher shape e domínio. |
| “A porta 3000 da demo não abre” | oci-networking | Segue o caminho VCN → subnet → security list/NSG → firewall do Ubuntu até achar o salto que falha. |
| OCR de documento, voz e transcrição (desafios 1, 2 e 4) | oci-ai-services | Vision, Document Understanding, Speech e Language, com os comandos certos da CLI. |
| LLM na OCI | oci-generative-ai | Planeja inferência e agentes no Generative AI, quando o acesso da conta estiver confirmado. |
| Resposta com fonte e busca em documentos (desafios 4 e 6) | oracle-db-vector-ai | Busca vetorial e Select AI dentro do Oracle Database. |
| Banco e painel rápido | oracle-autonomous-db · oracle-apex | Provisiona e conecta o Autonomous Database e entrega telas em APEX. |
| “Quanto isso vai gastar do crédito?” | oci-free-tier · oci-cost-analysis | Explica o Always Free, o ciclo do trial e estima custo antes de criar recurso. |
Antes de confiar
- No OpenCode não existe guarda automática de comandos. Leia todo comando
ocique cria, altera ou apaga recurso antes de aprovar. No Claude Code o pacote inclui um aviso antes de escritas reconhecidas. Em qualquer agente, quem limita o que pode ser feito é a permissão (IAM) da conta. - As 15 ferramentas MCP só leem. As que consultam a sua conta precisam da OCI CLI configurada; as skills e a consulta de preços funcionam sem credencial.
- As receitas que alteram recursos foram verificadas na forma do comando, não executadas em todas as contas. Confira o plano antes de aplicar e registre o que criou.
- Nunca cole OCID, chave ou IP da equipe em repositório ou material público.
O que tem na Oracle?
Abra um serviço para entender o que faz e onde pode entrar na sua demo. Este mapa reúne as principais peças para o hackathon; a documentação completa da OCI lista os demais serviços.
IA, documentos e voz
Generative AI
Modelos de texto e multimodais por API.
No desafio: Resumir uma transcrição fictícia, extrair tarefas ou responder com contexto.
Opcional: acesso depende da conta, região e limites. Verifique no console antes de depender deste serviço na demo. Para texto, o roteiro também oferece Nemotron em Compute.
Generative AI Agents
Serviço gerenciado para agentes conectados a dados e ferramentas.
No desafio: Experimentar um assistente sobre documentos do desafio.
Opcional: acesso depende da conta, região e limites. Verifique no console antes de depender deste serviço na demo. Para texto, o roteiro também oferece Nemotron em Compute.
Vision
Análise de imagens e reconhecimento de texto.
No desafio: Ler campos de uma imagem de documento fictício.
Document Understanding
Extração de texto, tabelas e campos de documentos.
No desafio: Transformar um formulário de demonstração em dados estruturados.
Speech
Transcrição de áudio para texto.
No desafio: Converter uma gravação simulada de atendimento; confira idiomas suportados.
Language
Análise de idioma, entidades e sentimento.
No desafio: Classificar mensagens quando o idioma e a função estiverem disponíveis.
Data Science
Notebooks e ambientes para treinar e servir modelos.
No desafio: Experimentar modelos sobre um conjunto sintético do desafio.
Aplicações, rede e execução
Compute
Máquinas virtuais para o app, os agentes e, no perfil com RAM suficiente, o Nemotron em CPU.
No desafio: Hospedar app, gateway LiteLLM e banco da demonstração.
Container Instances
Execução de containers sem administrar uma VM para cada aplicação.
No desafio: Rodar uma API empacotada pela equipe.
Container Registry
Registro para armazenar imagens de container.
No desafio: Guardar a imagem usada no deploy da demo.
OKE
Kubernetes gerenciado.
No desafio: Coordenar serviços quando a equipe já domina Kubernetes.
Functions
Funções acionadas sob demanda.
No desafio: Processar um evento de autorização ou arquivo recebido.
API Gateway
Publicação e controle de APIs da aplicação.
No desafio: Organizar rotas de entrada do backend. É diferente do gateway de IA LiteLLM.
VCN e NSG
Rede virtual e regras de acesso dos recursos.
No desafio: Conectar a VPS e liberar apenas os acessos necessários.
Load Balancer
Distribuição de tráfego entre backends.
No desafio: Roteamento de uma aplicação com mais de uma instância.
Dados, arquivos e busca
Autonomous Database
Banco Oracle gerenciado.
No desafio: Guardar pacientes fictícios, autorizações e tarefas.
AI Vector Search
Busca por semelhança em versões compatíveis do Oracle Database.
No desafio: Recuperar trechos de documentos para dar contexto à IA.
MySQL HeatWave
Serviço MySQL com recursos analíticos.
No desafio: Persistir dados quando a equipe já trabalha com MySQL.
Object Storage
Armazenamento de objetos, como PDFs, fotos e áudios.
No desafio: Guardar os arquivos fictícios usados por OCR ou transcrição.
Block Volume
Disco em bloco para instâncias.
No desafio: Armazenar dados da aplicação na VPS.
File Storage
Sistema de arquivos compartilhado.
No desafio: Compartilhar arquivos entre ambientes que precisam desse acesso.
Interfaces e integração
APEX
Desenvolvimento low-code de aplicações sobre dados.
No desafio: Criar a fila de autorizações ou um painel de acompanhamento.
Visual Builder
Ferramentas visuais para interfaces e aplicações.
No desafio: Montar telas ligadas às APIs do projeto.
Queue
Fila de mensagens para processamento assíncrono.
No desafio: Separar o recebimento de um pedido da execução da tarefa.
Streaming
Ingestão de fluxos de eventos.
No desafio: Receber eventos simulados dos quartos inteligentes.
Events
Regras para reagir a eventos de recursos OCI.
No desafio: Disparar processamento quando um recurso ou arquivo muda.
Email Delivery
Envio de e-mail transacional.
No desafio: Enviar uma notificação de teste com destinatário autorizado.
Notifications
Distribuição de notificações a destinos configurados.
No desafio: Avisar a equipe sobre um alerta da operação.
Operação, acesso e custos
Logging e Monitoring
Logs, métricas e alarmes dos recursos.
No desafio: Entender por que a API parou ou por que a resposta demorou.
IAM
Usuários, grupos, identidades e políticas de acesso.
No desafio: Definir quem pode usar quais recursos no compartment.
Vault
Armazenamento e gestão de segredos e chaves.
No desafio: Centralizar segredos quando a arquitetura precisar disso.
Bastion
Acesso administrativo temporário a recursos privados.
No desafio: Entrar em uma VPS sem expor um acesso administrativo permanente.
Budgets e Cost Analysis
Acompanhamento de orçamento e consumo.
No desafio: Saber quanto a equipe está usando durante e depois do evento.
Resource Manager
Infraestrutura declarativa com Terraform.
No desafio: Reproduzir um ambiente a partir de uma configuração versionada.
Como escolher para sua equipe?
| Desafio | Ponto de partida possível |
|---|---|
| Recepção / cadastro | App em Compute + Document Understanding ou Vision + base de dados. |
| Autorizações | API + Queue + painel APEX. |
| Copiloto de insights | Speech + LLM em Compute (ou GenAI com acesso) + documentos com fonte. |
| Acompanhamento | LLM em Compute (ou GenAI com acesso) + tarefas no banco + painel da equipe. |
| Atendimento com regras | Object Storage + busca nos documentos + LLM em Compute (ou GenAI com acesso). |
| Quarto inteligente | Eventos simulados + API + painel + Logging. |
São combinações possíveis, não requisitos. A stack é livre. Confirme disponibilidade, permissões e preços no console antes de depender de um serviço.
Créditos e continuidade.
O trial público é o mesmo crédito do evento?
Cada equipe terá uma conta com US$ 300. Confira as condições da conta entregue pela organização; o trial público padrão tem suas próprias regras e validade.
Como acompanhar custos depois da apresentação?
Revise Cost Analysis e os recursos criados. Combine com a equipe o que precisa continuar ligado, quem acompanha o consumo e o que pode ser encerrado. Orçamento ou alerta não substitui essa revisão.