agntk: A Zero-Configuration Modular AI Agent Framework

agntk is a modular AI agent framework built on the Vercel AI SDK, supporting zero-configuration startup, persistent memory, sub-agent derivation, and local model inference, providing developers with an out-of-the-box AI agent development experience.

agntk's slogan is concise and clear: "AI agent you install and point at problems. Zero config. Works immediately." This design philosophy directly addresses the pain point of current agent toolchains—excessive configuration.

The framework is built on the Vercel AI SDK, which means it inherits capabilities like streaming responses, tool calls, and structured outputs from the SDK. However, agntk's value does not lie in reinventing the wheel, but in encapsulating these capabilities into a form that developers can use immediately.

agntk implements an intelligent Provider detection mechanism that automatically selects available AI services by priority:

Priority	Provider	Detection Method
1	User API Key	Environment variables OPENROUTER_API_KEY, OPENAI_API_KEY, or CEREBRAS_API_KEY
2	Ollama	Automatically detect localhost:11434 and select appropriate model based on hardware
3	Free Tier	Built-in Cerebras support (limited rate)

This design allows developers to not worry about underlying model configuration. If there is an API Key, use paid services; if not, automatically fallback to local Ollama or free tier.

When using Ollama for local inference, agntk detects system hardware and automatically selects the optimal model:

Memory Capacity	Model Selection	Strategy Explanation
8 GB	qwen3:8b	Moderate memory usage, reserves space for the operating system
16 GB	qwen3:14b Standard + qwen3:8b Fast	Optimal balance between quality and speed
32+ GB	qwen3:32b Inference + qwen3:14b Standard	Full performance for complex tasks, high efficiency for regular tasks

The framework detects Apple Silicon unified memory, NVIDIA VRAM, and pure CPU systems, and automatically adjusts the model selection strategy.

Each agntk agent comes with 20+ built-in tools by default, no additional configuration required:

• File Tools: Read, write, edit, create, glob matching, cross-workspace grep search
• Code Tools: AST-based search and replace (ast-grep)

• Shell Tools: Run commands, manage background processes
• Browser Tools: Web navigation, content extraction, page interaction

• Planning Tools: Task decomposition, deep reasoning
• Memory Tools: Factual memory, context recall, cross-session knowledge building
• Sub-agent Tools: Derive specialized agents for parallel work, support real-time activity streams
• Skill Tools: Automatically discover SKILL.md files in the project and load project-specific capabilities

The completeness of this toolset means developers do not need to write custom tools for common tasks and can focus on business logic.