Axon Agent

A powerful full-stack AI agent framework for autonomous task execution

English Documentation | Documentação em Português

---

🌍 Language / Idioma

English

Axon Agent is a full-stack AI agent framework that combines a Python FastAPI backend with a modern React TypeScript frontend. It provides an extensible platform for creating autonomous AI agents capable of executing complex tasks through multi-tool coordination, intelligent planning, and decision-making.

📖 Complete Documentation

→ Read the full English documentation here

The complete documentation includes:

• ✅ Project overview and architecture
• ✅ Complete technology stack
• ✅ Installation and setup guide
• ✅ Usage examples and API reference
• ✅ Development workflow
• ✅ Contributing guidelines

🚀 Quick Start

# Clone the repository
git clone https://github.com/crislerwin/Axon-Agent.git
cd axon-agent

# Install dependencies
npm run install

# Configure
cp api/config/config.example.toml api/config/config.toml
# Edit config.toml with your API keys

# Run
npm run dev

Access the application at http://localhost:3000

📚 Additional Resources

• Architecture Documentation
• Getting Started Guide
• API Reference
• Examples

---

Português

Axon Agent é um framework full-stack de agentes de IA que combina um backend Python FastAPI com um frontend moderno em React TypeScript. Ele fornece uma plataforma extensível para criar agentes de IA autônomos capazes de executar tarefas complexas através de coordenação multi-ferramenta, planejamento inteligente e tomada de decisões.

📖 Documentação Completa

→ Leia a documentação completa em português aqui

A documentação completa inclui:

• ✅ Visão geral do projeto e arquitetura
• ✅ Stack de tecnologia completa
• ✅ Guia de instalação e configuração
• ✅ Exemplos de uso e referência da API
• ✅ Fluxo de desenvolvimento
• ✅ Diretrizes de contribuição

🚀 Início Rápido

# Clone o repositório
git clone https://github.com/crislerwin/Axon-Agent.git
cd axon-agent

# Instale as dependências
npm run install

# Configure
cp api/config/config.example.toml api/config/config.toml
# Edite config.toml com suas chaves de API

# Execute
npm run dev

Acesse a aplicação em http://localhost:3000

📚 Recursos Adicionais

• Documentação de Arquitetura
• Guia de Início
• Referência da API
• Exemplos

---

✨ Key Features / Recursos Principais

English 🤖 Multiple specialized AI agents 🔧 Extensible tool system 🌐 Web automation & browser control 🔍 Multi-engine web search 💻 Safe code execution 📊 Real-time progress streaming 🌍 Multilingual support (EN/PT) 🎨 Modern responsive UI

Português 🤖 Múltiplos agentes de IA especializados 🔧 Sistema de ferramentas extensível 🌐 Automação web e controle de navegador 🔍 Pesquisa web multi-motor 💻 Execução segura de código 📊 Streaming de progresso em tempo real 🌍 Suporte multilíngue (EN/PT) 🎨 Interface moderna e responsiva

---

🏗️ Technology Stack / Stack de Tecnologia

Backend

• FastAPI - High-performance async web framework
• OpenAI SDK - LLM integration (OpenAI, Azure, Ollama)
• Playwright - Browser automation
• Pydantic - Data validation

Frontend

• React + TypeScript - Modern UI framework
• Vite - Fast build tool
• Tailwind CSS - Utility-first styling
• Shadcn/ui - Accessible component library
• i18next - Internationalization

---

📋 Use Cases / Casos de Uso

English Travel planning with research Web research and compilation Code generation and testing Content creation Web automation tasks Complex task planning

Português Planejamento de viagens com pesquisa Pesquisa e compilação web Geração e teste de código Criação de conteúdo Automação de tarefas web Planejamento de tarefas complexas

---

🤝 Contributing / Contribuindo

English We welcome contributions! Please see our Contributing Guidelines for details. Fork the repository Create a feature branch Make your changes Add tests Submit a pull request

Português Aceitamos contribuições! Por favor, veja nossas Diretrizes de Contribuição para detalhes. Faça fork do repositório Crie um branch de feature Faça suas alterações Adicione testes Envie um pull request

---

📄 License / Licença

This project is licensed under the MIT License - see the LICENSE file for details.

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

---

📞 Support / Suporte

English Issues: GitHub Issues Email: crislerwintler@gmail.com

Português Problemas: GitHub Issues Email: crislerwintler@gmail.com

---

🙏 Acknowledgments / Agradecimentos

Built with love using FastAPI, React, OpenAI, Playwright, Shadcn/ui, and many other amazing open-source projects.

Construído com amor usando FastAPI, React, OpenAI, Playwright, Shadcn/ui, e muitos outros projetos open-source incríveis.

---

Made with ❤️ by crislerwin

⭐ Star this repository if you find it helpful! / Dê uma estrela se achar útil!