Java-based Autonomous AI Assistant SDK
Open-source generalist agent for real-world tasks via natural language and secure
┌───────────────────────────────────────────────────────────────────┐
│ Client Layer │
└─────────────────────────────────┬─────────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────────────┐
│ Controller Layer │
│ ┌─────────────────┐ ┌────────────────┐ ┌────────────────────┐ │
│ │ AgentController │ │ AuthController │ │ BillingController │ │
│ └─────────────────┘ └────────────────┘ └────────────────────┘ │
└─────────────────────────────┬─────────────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────────────┐
│ Service Layer (Agent) │
│ ┌─────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
│ │ AgentRunManager │ │ BackgroundService │ │ ToolOrchestrator │ │
│ └─────────────────┘ └──────────────────┘ └──────────────────┘ │
└─────────────────────────────┬─────────────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────────────┐
│ Service Layer (AgentPress) │
│ ┌────────────────┐ ┌───────────────┐ ┌─────────────────────┐ │
│ │ ThreadManager │ │ ToolRegistry │ │ ResponseProcessor │ │
│ └────────────────┘ └───────────────┘ └─────────────────────┘ │
│ ┌────────────────┐ ┌───────────────┐ ┌─────────────────────┐ │
│ │ ContextManager │ │ LlmService │ │ StorageService │ │
│ └────────────────┘ └───────────────┘ └─────────────────────┘ │
└─────────────────────────────┬─────────────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────────────┐
│ Infrastructure Layer │
│ ┌────────────────┐ ┌───────────────┐ ┌─────────────────────┐ │
│ │ DBConnection │ │ RedisService │ │ RabbitMQ Client │ │
│ └────────────────┘ └───────────────┘ └─────────────────────┘ │
└───────────────────────────────────────────────────────────────────┘
Client AgentController AgentRunnerService OpenAILlmService Tools
| | | | |
|-- POST /api/agent/runs --------------->| | | |
| | | | |
| |-- Auth & validate ---------------+| | |
| |-- Create account/project --------+| | |
| |-- Provision sandbox -------------+| | |
| |-- Create thread -----------------+| | |
| |-- Upload files ------------------->| | |
| | | | |
|<-- 200 OK (agentRunId, threadId) ------| | | |
| | | | |
|-- GET /runs/{id}/stream -------------->| | | |
| |-- Setup SSE emitter ------------->| | |
| | | | |
| |-- submitAgentRun --------------->+| | |
| | |-- executeAgentRun() ------------->| |
| | |-- Register tools ---------------->| |
| | | | |
| | |-- Execute iteration ------------->| |
| | | |-- LLM API call ----------------->|
| | | |<-- LLM Response -----------------|
| | | | |
| | | |-- Parse tool calls ------------->|
| | | | |-- Execute tool call ----+
| | | | |<- Tool result ----------+
| | | |<-- Tool execution result --------|
| | |<-- AgentLoopResult ---------------| |
| | | | |
| | |-- Publish to Redis ------------->+| |
|<-- SSE Event (message) ---------------| | | |
| | | | |
| | |-- [Repeat loop until complete] -->| |
| | | | |
|<-- SSE Event (completion) ------------| | | |
| | | | |
+----------------------------------------+-----------------------------------+-----------------------------------+----------------------------------+
🚀 Quick Start • 📖 Documentation • 🎯 Examples • 💬 Community
Nubian AI is an intelligent agent that acts on your behalf to accomplish complex tasks through natural conversation. Unlike traditional chatbots, Nubian can:
- 🌐 Browse the web and extract real-time information
- 📁 Manage files and create documents
- 💻 Execute code safely in isolated environments
- ⚖️ Handle legal workflows with specialized tools
- 🔄 Stream responses in real-time
Perfect for: Researchers, legal professionals, developers, and anyone who needs an AI assistant that can actually do things, not just talk about them.
|
|
|
|
Get Nubian AI running in under 5 minutes:
Suna.so for the inspiration (https://github.com/kortix-ai/suna)
The end goal is to port Suna.so 100% from Python to Java now we are 80% close
For full doc: https://github.com/suevip1/nubian-ai-agent-framework/tree/main/docs