AI Crews

Crews are teams of AI agents that work together to complete a task. Each crew has agents with specific roles, tools, and a sequence of tasks to execute.

Starting a crew project

bash /srv/shared/projects/new-project.sh <template> <project-name>
cd ~/projects/<project-name>
source .venv/bin/activate

Available templates

research-crew

Researches a topic using web search and writes a report to your Obsidian vault.

PYTHONPATH=src python -m research_crew.main "topic to research"
 
# Custom output path
PYTHONPATH=src python -m research_crew.main "topic" "projects/my-report.md"

Agents:

Research Analyst — searches the web, reads context from Obsidian
Report Writer — structures findings into a markdown report, saves to Obsidian

Tools available to all crews:

Tool	What it does
`DuckDuckGoSearchTool`	Web search, no API key needed
`WebScrapeTool`	Fetch and extract text from any URL
`PythonSandboxTool`	Run Python in an isolated container (no network, 512MB RAM)
`ObsidianReadTool`	Read a note from your vault
`ObsidianWriteTool`	Write a note to your vault
`ObsidianListTool`	List notes in your vault

Choosing a model

Edit .env in your project directory:

RESEARCHER_MODEL=qwen3-general   # or claude-sonnet for harder tasks
WRITER_MODEL=qwen3-general

Writing a brief

Create a note in Obsidian before running the crew, then reference it:

PYTHONPATH=src python -m research_crew.main \
  "See brief at projects/my-brief.md" \
  "projects/output.md"

The researcher agent will use ObsidianReadTool to pull in your brief.

Models How Crews Work