Workspace de inteligência artificial completo com chat, criação de agentes e geração de mídia, agora com suporte nativo de primeiro escalão ao ecossistema MiniMax.
O odysseus-minimax é uma versão aprimorada do projeto open-source Odysseus AI Workspace (criado originalmente por pewdiepie-archdaemon). O projeto base suportava provedores tradicionais (OpenAI, Anthropic, DeepSeek), mas carecia totalmente de suporte à MiniMax. Alex Santos desenvolveu a integração completa do ecossistema MiniMax, adicionou detecção inteligente de domínios (.io vs .com), criou o comando no terminal `/setup minimax`, implementou suporte a aspect ratio e batch no image-01 e resolveu 4 bugs arquiteturais críticos na camada upstream de roteamento.
Visão macro de como o projeto processa requisições, gerencia dados e entrega valor técnico com máxima eficiência.
+-----------------------+ +---------------------------+ +-----------------------+
| Odysseus Web UI | ===> | Backend Odysseus (FastAPI)| ===> | Roteador de Provedores|
| (Chat, Prompts, Mídia)| | (Controle de Sessão) | | (OpenAI, Claude...) |
+-----------------------+ +---------------------------+ +-----------------------+
|
+---> [NOVO] MiniMax Adapter
|
+----------------------------+----------------------------+
| |
v v
+-------------------------+ +-------------------------+
| MiniMax M3 (Texto & | | MiniMax image-01 |
| Raciocínio de Longo Cx) | | (Geração de Imagens) |
+-------------------------+ +-------------------------+Decisões de design, algoritmos e técnicas aplicadas para garantir confiabilidade, segurança e excelência operacional.
Permite selecionar modelos MiniMax diretamente no seletor de modelos da interface web. As mensagens de chat utilizam a API de chat completions da MiniMax, enquanto comandos de criação de imagens ativam o gerador nativo image-01 com suporte a proporções e seeds.
Criou o assistente CLI `/setup minimax` que orienta o usuário passo a passo: pergunta a chave de API, valida a conectividade em tempo real e armazena os parâmetros criptografados no banco de dados local da aplicação.
A MiniMax opera com dois domínios distintos dependendo da região da conta do desenvolvedor (`api.minimax.chat` internacional vs `api.minimaxi.com` asiático). O adaptador implementado por Alex detecta o prefixo da chave e direciona as requisições para o endpoint correto sem falhas de autenticação.
Corrigiu 4 bugs no core original do Odysseus: 1) duplicação de caminho de URL (`/v1/v1/chat/completions`), 2) resolução de modelos visuais não listados no catálogo padrão `/v1/models`, 3) tratamento do prefixo `_IMAGE_MODEL_PREFIXES` e 4) exclusão de modelos puramente visuais do seletor de chat textual para prevenir erros de execução.
Exemplo concreto de uso, configuração e integração técnica.
# Correção do path duplo e detecção de domínio no Odysseus
def get_minimax_endpoint(api_key: str, endpoint_type: str = "chat") -> str:
domain = "api.minimax.chat" if api_key.startswith("mm-") else "api.minimaxi.com"
# Previne a falha upstream de duplicação /v1/v1/
base = f"https://{domain}/v1"
if endpoint_type == "chat":
return f"{base}/text/chatcompletion_v2"
elif endpoint_type == "image":
return f"{base}/image_generation"
return baseEsclarecimentos detalhados sobre funcionamento, licenças, compatibilidade e privacidade.
O Odysseus é um workspace excelente para produtividade local, mas ignorava completamente a MiniMax, que oferece uma das melhores relações custo-benefício e qualidade de geração de imagens do mercado.
As correções estabilizaram toda a camada de rede do Odysseus, eliminando bugs que também causavam falhas intermitentes em provedores como OpenRouter e DeepSeek.
Basta clonar o repositório, instalar os requisitos (`pip install -r requirements.txt`) e rodar `python main.py`. O workspace subirá na porta 8000.
Sim, a interface do Odysseus conta com suporte completo a upload de documentos e análise via RAG.