A powerful local AI agent using DeepSeek-R1:1.5B via Ollama and Vercel AI SDK

• 🧠 Advanced Reasoning: Powered by DeepSeek-R1:1.5B reasoning model
• 🛠️ Tool Calling: Calculator, file operations, web search simulation, code generation
• 💬 Interactive Chat: Streaming responses with conversation history
• 🎨 Beautiful CLI: Rich formatting with colors, gradients, and animations
• 📚 Memory: Persistent conversation history within sessions
• 🔄 Real-time: Live streaming responses as the AI thinks
• 🎯 Local: Runs completely offline after initial setup

1. Node.js 18+: Download here
2. Ollama: Install locally

   # macOS/Linux
   curl -fsSL https://ollama.ai/install.sh | sh
   # Windows
   # Download from https://ollama.ai/download

1. Clone and setup:

   git clone <your-repo-url>
   cd deepseek-ai-agent
   npm install

2. Install the DeepSeek-R1:1.5B model:

   # Pull the model (this will download ~1.1GB)
   ollama pull deepseek-r1:1.5b
   # Or use the npm script
   npm run install-model

3. Start Ollama service (if not running):

   ollama serve

4. Run the AI Agent:

   npm start
   # or
   node ai-agent.js

Once started, you'll see a beautiful banner and command prompt. Here are the available commands:

In chat mode, the AI can:

• Answer questions with advanced reasoning
• Use tools automatically (calculator, file operations, etc.)
• Generate code in any programming language
• Maintain conversation context
• Stream responses in real-time

Example chat session:

🧑 You: Can you help me calculate the area of a circle with radius 5 and then write Python code to do this calculation?
🤖 AI: I'll help you calculate the area of a circle with radius 5 and then provide Python code for this calculation.
First, let me calculate the area using the formula A = πr2:
🔧 Tool Results:
 Tool: calculator
 Result: {
 "result": "78.53975",
 "expression": "3.14159 * 5 * 5"
 }
The area of a circle with radius 5 is approximately 78.54 square units.
Now, here's Python code to calculate the area of a circle:
```python
import math
def circle_area(radius):
 """Calculate the area of a circle given its radius."""
 return math.pi * radius ** 2
# Example usage
radius = 5
area = circle_area(radius)
print(f"The area of a circle with radius {radius} is {area:.2f} square units")

The AI agent has access to several built-in tools:

Perform mathematical calculations safely:

> calc 15 * 42 + sqrt(16)
✅ 15 * 42 + sqrt(16) = 634

Read, write, and list files:

> files
📁 Files in .:
 • ai-agent.js
 • package.json
 • README.md

Simulate web search results (extend for real implementation):

// In chat mode, ask: "Search for information about Node.js"
// The AI will use the webSearch tool automatically

Generate code in any programming language:

> code javascript "function to reverse a string"
💻 Generated JavaScript Code:
function reverseString(str) {
 return str.split('').reverse().join('');
}

DeepSeek-R1 features advanced reasoning capabilities. Use the think command for complex problems:

> think How would you design a scalable microservices architecture for an e-commerce platform?
🧠 Deep Reasoning Result:
[Detailed reasoning about microservices architecture, including:
- Service decomposition strategies
- Data management patterns
- Communication protocols
- Scaling considerations
- Security implications]

You can modify the model settings in ai-agent.js:

const model = ollama('deepseek-r1:1.5b', {
 temperature: 0.7, // Creativity level (0.0-1.0)
 simulateStreaming: true, // Enable streaming responses
 // Add more Ollama-specific options
});

Add your own tools by extending the tools object:

const tools = {
 // ... existing tools
 
 customTool: {
 description: 'Your custom tool description',
 parameters: z.object({
 param: z.string().describe('Parameter description'),
 }),
 execute: async ({ param }) => {
 // Your tool logic here
 return { result: 'Tool result' };
 }
 }
};

The agent supports rich customization:

• Colors: Modify gradients and chalk colors
• Styling: Change boxen styles and borders
• Commands: Add new commands to the commands object
• Tools: Extend functionality with custom tools
• Model: Switch to different Ollama models

1. Model not found:

   Error: Model deepseek-r1:1.5b not found
   # Solution: Pull the model
   ollama pull deepseek-r1:1.5b

2. Ollama not running:

   Error: Connection refused
   # Solution: Start Ollama service
   ollama serve

3. Permission errors:

   # On macOS/Linux, you might need:
   chmod +x ai-agent.js

4. Out of memory:

   • Close other applications
   • Use a smaller model variant
   • Add more RAM to your system

Enable debug logging by setting the environment variable:

DEBUG=* node ai-agent.js

• Local execution: All data stays on your machine
• Safe evaluation: Calculator uses Function constructor with restrictions
• File access: Limited to current directory by default
• No external calls: Web search is simulated (safe for local use)

• Plugin system for custom tools
• Multiple model support (switch between models)
• Conversation export (JSON, Markdown)
• Real web search integration
• Voice input/output support
• GUI version using Electron
• Docker containerization
• Multi-language support

Contributions are welcome! Please feel free to submit a Pull Request. Areas where help is needed:

• Additional tool implementations
• UI/UX improvements
• Performance optimizations
• Documentation enhancements
• Bug fixes and testing

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

• DeepSeek for the amazing R1 reasoning model
• Ollama for local model serving
• Vercel for the excellent AI SDK
• Community for tool inspirations and feedback

If you encounter any issues or have questions:

1. Check the troubleshooting section
2. Search existing issues
3. Create a new issue with detailed information