O desenvolvedor Nataniel Fiuza publicou no Python Package Index (PyPI) o pydeepseek-tui, um pacote que oferece uma interface de terminal (TUI, sigla para Terminal User Interface) voltada à interação com modelos de inteligência artificial como DeepSeek, OpenAI e Anthropic. A ferramenta permite que profissionais utilizem capacidades de IA generativa diretamente no terminal, sem dependência de interfaces gráficas, o que a torna adequada para uso em ambientes de desenvolvimento e servidores remotos com recursos limitados. A versão mais recente disponível é a 0.1.1.
A instalação é feita via pip, o gerenciador de pacotes padrão do ecossistema Python. O projeto exige Python 3.13 ou superior e, na primeira execução, solicita ao usuário a chave de API do provedor escolhido. Essa credencial é armazenada de forma encriptada no diretório ~/.deepseek-tui/.env, com a proteção garantida pela biblioteca cryptography na versão 48.x. O projeto é de código aberto e aceita contribuições da comunidade.
A interface foi construída sobre o Textual, um arcabouço para criação de TUIs em Python, e opera de maneira assíncrona, o que significa que as requisições aos modelos de IA não bloqueiam a interação do usuário com o terminal. A comunicação com os provedores utiliza os SDKs oficiais da OpenAI e da Anthropic, além do cliente HTTP httpx para funcionalidades de ferramentas web.
O pydeepseek-tui suporta múltiplos provedores de IA por meio de uma arquitetura modular que organiza os adaptadores em um diretório dedicado dentro do código-fonte. DeepSeek, OpenAI e Anthropic são os provedores atualmente suportados, e a estrutura do projeto sugere que a adição de novos provedores pode ser feita com relativa facilidade.
Além da conversa simples com modelos de IA, a ferramenta funciona como um agente com oito ferramentas integradas. Essas ferramentas ampliam o alcance da interação para além da geração de texto, incluindo capacidades como pesquisa web via DuckDuckGo, extração de conteúdo de páginas da internet com BeautifulSoup e execução de comandos no sistema operacional.
A segurança da execução é controlada por três modos de operação distintos, acessíveis pelo atalho de teclado m. No modo Plan, o agente tem acesso apenas a ferramentas de leitura, com operações de shell, escrita e git bloqueadas. No modo Agent, o sistema solicita confirmação do usuário por meio de um modal interativo antes de executar qualquer ferramenta considerada destrutiva. Já o modo YOLO executa todas as ferramentas sem pedir confirmação, destinado a cenários em que o usuário confia plenamente nas ações do agente.
A interface de usuário oferece atalhos de teclado para as operações mais comuns. A tecla q encerra a aplicação e salva a sessão atual, permitindo que o usuário retome a conversa posteriormente. A tecla c limpa o histórico do chat, e a tecla m alterna entre os três modos de operação.
A internacionalização é outro recurso presente no projeto, com suporte a pelo menos dois idiomas: português brasileiro (pt_BR) e inglês americano (en_US). Essa funcionalidade está organizada em um módulo dedicado de traduções dentro da estrutura do pacote.
A arquitetura do projeto foi estruturada em módulos separados para atender a responsabilidades específicas. O módulo agent gerencia o loop de execução do agente, os modos de operação, as sessões e o registro de atividades. O módulo cli lida com os comandos de linha de comando por meio da biblioteca Click. O módulo config cuida das configurações, da encriptação e do registro de depuração. Os provedores ficam no módulo providers, as ferramentas no módulo tools e toda a interface visual no módulo tui.
Para o desenvolvimento do projeto, Fiuza adotou ferramentas como Pipenv para gerenciamento de ambientes virtuais, pytest com extensões para testes assíncronos e cobertura de código, além de Ruff e Black para formatação e verificação de estilo, e Mypy para verificação de tipos estáticos. Um Makefile centraliza os comandos mais utilizados no fluxo de desenvolvimento.
A publicação no PyPI simplifica consideravelmente a adoção, já que basta executar pip install pydeepseek-tui para ter a ferramenta disponível no ambiente. A disponibilidade de distribuição em formato wheel e em código-fonte garante compatibilidade com diferentes sistemas operacionais.
A proposta do pydeepseek-tui se alinha a uma tendência crescente entre desenvolvedores que preferem trabalhar exclusivamente no terminal, seja por questões de produtividade, hábito ou limitações de infraestrutura. Ao reunir múltiplos provedores de IA, ferramentas integradas e modos de operação configuráveis em um único pacote instalável via pip, o projeto oferece uma alternativa prática para quem deseja interagir com modelos de IA generativa sem sair da linha de comando.
