- Accepts a person’s name, email, and organization
- Searches the web to gather company and person information
- Generates a detailed research report with personalized recommendations
- Streams results in real-time through a modern web UI

Quick start
1
Sign up and install the autonomy command
Complete the steps to get started with Autonomy.
2
Get a Linkup API key
Sign up at Linkup and get your API key. Linkup provides a web search API that the agent uses to gather information.See the Linkup Python SDK documentation for more details.
3
Get the example code
/dev/null/terminal.sh
File Structure:
4
Create secrets.yaml
Create a
secrets.yaml file with your Linkup API key:secrets.yaml
5
Deploy
/dev/null/terminal.sh
Build with a coding agent
You can also build this application from scratch using a coding agent like Claude Code, Cursor, or Codex CLI.1
Sign up and install the autonomy command
Complete the steps to get started with Autonomy.
2
Get a Linkup API key
Sign up at Linkup and get your API key.
3
Give your coding agent this prompt
Prompt:
How it works
The application uses a research agent powered by Claude with access to web search tools via the Linkup API. The agent has two tools to gather information using the Linkup API:images/main/main.py
images/main/main.py
images/main/main.py
images/main/main.py
Customize the agent
Edit the agent instructions inimages/main/main.py to focus on different aspects:
images/main/main.py
images/main/main.py
images/main/main.py
API reference
Research a new signup and stream the results viaPOST /api/research.
Request:
/dev/null/request.json
/dev/null/response.json
Integrate into your product
The/api/research endpoint is a standard HTTP API that you can call from anywhere, not just the included web UI. This makes it easy to integrate signup research into your existing workflows and products.
Trigger research automatically when a new user signs up:
/dev/null/example.py
Learn more
Models
Available models for agents.
Agents
Build agents with custom instructions and tools.
Tools
Give agents the ability to take actions.
Programming Interfaces
Create APIs for Autonomy applications.
Linkup API key not working
Linkup API key not working
- Verify your API key at app.linkup.so.
- Check that
secrets.yamlis in the correct format. - Ensure the key is passed as
LINKUP_API_KEYenvironment variable.
Research takes too long
Research takes too long
- The agent typically completes in 30-60 seconds.
- Check your zone logs for timeout errors.
- Consider reducing the number of searches in the agent instructions.
Agent not finding relevant information
Agent not finding relevant information
- Try more specific organization names.
- The person may have limited online presence.
- Check if the company website is accessible.
Streaming not working in UI
Streaming not working in UI
- Verify the UI is built and deployed:
cd ui && npm run build-autonomy. - Check browser console for JavaScript errors.
- Ensure the API endpoint returns proper streaming JSON.

