Bem-vindo ao Juliana Pro!
O Juliana Pro é uma plataforma robusta desenvolvida para otimizar a criação, teste e deploy de aplicações
alimentadas por IA. A plataforma é dividida em dois modos de trabalho principais de alta performance.
💡 Dica Rápida: Use o Modo Construtor para gerenciar seus arquivos,
codificar e gerenciar servidores locais. Use o Modo Agente para tarefas conceituais,
pesquisas rápidas e automações diretas com IA sem necessidade de projeto visual.
Estrutura Geral:
- Workspace & IDE: Ambiente de codificação Monaco com terminal integrado e git.
- Hub Central: Gerenciador de projetos locais e aplicações em produção.
- Agent Chat: Interface de inteligência artificial autônoma com execução de
ferramentas.
🛠️ Modo Construtor (IDE)
Interface rica para desenvolvimento de software completo diretamente no navegador com controle de porta
fixa por projeto.
1
Criar/Importar Projetos: No Painel Principal (Hub), clique em + Novo
Projeto ou use Importar Pasta / Clonar do Git.
2
Editor de Código: O editor Monaco oferece realce de sintaxe, atalhos clássicos do VS
Code, busca avançada e formatação automática.
3
Rodar a Aplicação: Na barra do explorador de arquivos, clique no botão de Play
(▶). O Watchdog alocará uma porta dedicada para o seu projeto de desenvolvimento (ex: 7000 a
7020). Clique no ícone de Globo (🌐) para abrir o app no navegador.
4
Controle com Git: Faça commits, visualize diffs detalhados de arquivos e envie seu
projeto ao GitHub usando o painel lateral do Git integrado na parte inferior da barra de arquivos.
💬 Modo Agente
O Modo Agente fornece um chat puro com a Juliana. Ela consegue entender contextos inteiros de projetos
locais e executar ações autônomas usando ferramentas integradas.
Principais Recursos:
- Upload de Documentos: Arraste ou selecione arquivos de código, imagens, planilhas ou
PDFs. A Juliana fará o processamento imediato do conteúdo.
- Memória Permanente: O sistema retém decisões anteriores sobre bancos de dados, chaves
e caminhos para consistência total.
- Criar Ferramentas (Custom Skills): Crie novas habilidades para estender o
comportamento da IA e utilizá-las dinamicamente em conversas futuras.
🛡️ Segurança e Resiliência: O Modo Agente possui tratamento nativo para erros de conexão
da API do DeepSeek, tentando reconectar de forma inteligente e protegendo o histórico do chat.
🚀 Publicação de Apps
Qualquer projeto criado no Modo Construtor pode ser publicado em um ambiente de produção independente e
escalado com facilidade.
1
Assistente de Publicação: Clique em + Publicar App na seção "Apps
Publicadas" do Hub. Selecione o projeto de origem.
2
Rotas & Slug: Defina o nome e a URL (Slug). A URL de produção gerada automaticamente
seguirá o padrão: https://[slug]-[userid]prod.julianapro.com.
3
Bancos de Dados: O assistente detectará automaticamente os bancos SQLite do seu
projeto. Você pode escolher copiar os dados de desenvolvimento locais para a produção ou iniciar com um
banco limpo/vazio.
4
Logs e Monitoramento: Cada app publicada possui um botão individual de
Logs. Clique nele para ver saídas do terminal, rastrear erros e status de conexões.
🔧 Solução de Problemas
Consulte esta seção antes de solicitar auxílio técnico.
⚠️ Erro de Timeout ou Lentidão extrema:
A arquitetura foi otimizada para threads de concorrência com 400 threads no AnyIO e 500 no
ThreadPoolExecutor. Caso haja lentidão, certifique-se de que a máquina física possui recursos livres
(CPU/RAM).
🔑 Limites e Cotas do DeepSeek (Erro 429):
Se as chaves de API do DeepSeek atingirem o limite de concorrência simultânea, utilize a rota de
balanceamento de chaves ou envie uma requisição ao suporte da API para expandir sua cota de usuário.
🚪 Aplicação não abre (Porta Ocupada):
Se a aplicação estiver "Online" mas inacessível, pare o projeto e reinicie-o para que o Watchdog libere e
force o bind correto da porta local.