Skip to main content

FAQ

General​

What is Sinaptic® DROID+?​

Sinaptic® DROID+ is a headless AI agent runtime engine. Like nginx serves websites, Sinaptic® DROID+ serves AI agents. You define agents in YAML configs, and Sinaptic® DROID+ exposes them as an OpenAI-compatible API. One binary, any LLM provider, built-in security.

Is Sinaptic® DROID+ open source?​

Sinaptic® DROID+ Community Edition is source-available under the Business Source License 1.1 (BSL 1.1). It's free to use for internal purposes with up to 2 agents. The license converts to Apache 2.0 after the change date. Pro and Enterprise editions are commercially licensed.

What's the difference between Community, Pro, and Enterprise?​

See the Editions comparison for a full feature matrix. In short: Community is free with up to 2 agents and RegExp-based security. Pro removes agent limits and adds the full SinapticAI security cascade. Enterprise adds multi-tenancy, compliance features, and SLA support.

Do I need to pay for Community Edition?​

No. Community Edition is free forever for internal use with up to 2 agents. No registration, no telemetry, no usage limits on API calls.

Installation & Setup​

What are the system requirements?​

Sinaptic® DROID+ is a single Go binary with zero external dependencies. It runs on Linux (amd64/arm64), macOS (Intel/Apple Silicon), and Windows. Memory usage depends on your workload, but 128MB is sufficient for basic setups.

Can I run Sinaptic® DROID+ without Docker?​

Yes. Sinaptic® DROID+ is a standalone binary. Download it from GitHub Releases, make it executable, and run droid up. Docker is optional.

How do I update Sinaptic® DROID+?​

For binary installs, download the new version and replace the binary. For Docker, docker pull sinapticai/droid:latest && docker compose up -d. Your config files and data are separate from the binary, so updates are non-destructive.

LLM Providers​

Which LLM providers are supported?​

All 7 providers are available in every edition: OpenAI, Anthropic (Claude), Google Gemini, xAI Grok, Ollama, LM Studio, and llama.cpp. Cloud providers require API keys. Local providers (Ollama, LM Studio, llama.cpp) require no keys.

Can I use different models for different agents?​

Yes. Each agent specifies its own model.provider and model.name. You can run one agent on GPT-4o, another on Claude Sonnet, and a third on a local Ollama model — all from the same Sinaptic® DROID+ instance.

Can I use Sinaptic® DROID+ with my own fine-tuned models?​

Yes. If your fine-tuned model is served via an OpenAI-compatible API (which most providers support), Sinaptic® DROID+ can use it. Just set the correct base_url and model name.

Does Sinaptic® DROID+ send my data anywhere?​

Sinaptic® DROID+ sends your prompts only to the LLM provider you configure. There is no telemetry, no analytics, and no data collection by Sinaptic® DROID+ itself. When using local models (Ollama, LM Studio, llama.cpp), everything stays on your machine.

Security​

What is SinapticAI?​

SinapticAI is an AI intent firewall embedded in Sinaptic® DROID+. It inspects prompts and responses in real time to detect and block prompt injection attacks, jailbreak attempts, and PII leaks. See the SinapticAI overview for details.

What attacks does the Community Edition detect?​

The Community Edition includes the RegExp security layer, which catches approximately 70% of known attack vectors: common prompt injection patterns, known jailbreak templates, system prompt extraction attempts, and PII patterns (emails, phone numbers, credit cards).

Can I disable SinapticAI for specific agents?​

Yes. Set sinaptic.enabled: false in the agent's YAML config. The global setting in droid.yaml controls the default.

Is my data processed locally for security checks?​

Yes. All SinapticAI checks run locally inside your Sinaptic® DROID+ instance. No data is sent to external services for security analysis.

API & Integration​

Is the API really OpenAI-compatible?​

Yes. Sinaptic® DROID+ implements the /v1/chat/completions endpoint with the same request/response format as OpenAI's API. You can use the official OpenAI SDK in any language — just change the base_url to your Sinaptic® DROID+ instance.

How do I authenticate API requests?​

By default, no authentication is required (local development mode). For production, configure an API key in droid.yaml:

server:
  api_key: "your-secret-key"

Then pass it in requests via the Authorization: Bearer your-secret-key header, just like with OpenAI.

Can I use Sinaptic® DROID+ as a drop-in replacement for OpenAI?​

Yes. Set base_url to your Sinaptic® DROID+ instance and use any agent name as the model parameter. The response format is identical to OpenAI's.

Agents​

What is the agent limit in Community Edition?​

Community Edition supports up to 2 agents. If you need more, upgrade to Pro (unlimited agents). The limit is on concurrent loaded agents, not on total configs.

Can I hot-reload agents without restarting?​

Yes. Sinaptic® DROID+ watches the agents directory for changes. When you modify an agent's YAML config, it's automatically reloaded without restarting the server or dropping active connections.

What tools can agents use?​

Agents can use built-in tools (current_time, etc.), REST API tools (call any HTTP endpoint), and MCP tools (Model Context Protocol for extensible integrations like web search, file access, databases). See the MCP guide.

Deployment​

What ports does Sinaptic® DROID+ use?​

Port 8080 for the OpenAI-compatible API and port 8081 for the Management API and Agent Builder UI. Both are configurable in droid.yaml.

Should I expose the Management API publicly?​

No. Port 8081 provides admin functionality and the Agent Builder UI. Keep it on an internal network or behind authentication in production.

Can I run multiple Sinaptic® DROID+ instances?​

Yes. Each instance is stateless (beyond its config files and data directory). You can run multiple instances behind a load balancer. For coordinated multi-instance deployments, the Enterprise edition provides clustering and HA features.

Troubleshooting​

Sinaptic® DROID+ starts but agents don't load​

Check that your agent YAML files are in the directory specified by agents_dir in droid.yaml (default: ./configs/agents/). Run droid agents to see loaded agents.

"Connection refused" when calling the API​

Make sure Sinaptic® DROID+ is running (droid health) and you're using the correct port (default 8080). If running in Docker, ensure ports are mapped correctly.

LLM calls fail with authentication errors​

Verify your API key is set correctly. Check with echo $OPENAI_API_KEY (or the relevant variable). The config supports ${VAR} syntax — make sure the environment variable is available to the Sinaptic® DROID+ process.