Quick Start Guide
Get started with OnPiste in 5 minutes
Quick Start Guide
Get up and running with OnPiste in just a few minutes.
Prerequisites
- Chrome or Edge browser
- OnPiste extension installed (Installation Guide)
- At least one LLM API key
Step 1: Configure Your LLM
-
Click the OnPiste icon in your toolbar
-
Click the Settings icon (āļø) in the top right
-
Navigate to LLM Settings
-
Add your API key for your preferred provider:
- OpenAI: Get key from platform.openai.com
- Anthropic: Get key from console.anthropic.com
- Google: Get key from ai.google.dev
- Ollama: Install locally and use
http://localhost:11434
-
Select models for each agent:
- Navigator: Handles web interactions (recommend Claude Haiku 3.5 or Gemini Flash)
- Planner: Creates strategies (recommend Claude Sonnet 4 or GPT-4o)
-
Click Save
Step 2: Try Your First Task
Let's start with a simple task. Open the OnPiste side panel and type:
Go to news.ycombinator.com and get the top 5 stories
What happens:
- The Planner creates a strategy
- The Navigator opens the website
- Agents extract the information
- Results are displayed in the chat
Step 3: Try More Complex Tasks
Research Task
Search for "best wireless headphones 2025" on Google and summarize the top 3 results
Product Comparison
Go to Amazon and find portable Bluetooth speakers under $50 with at least 10 hours battery life
Data Input
Enter "best laptops 2025" in the search box and click search
Understanding the Interface
Side Panel Components
Chat Area
- Type your commands here
- View agent responses and progress
- Ask follow-up questions
Status Indicators
- š¢ Active: Agents are working
- š” Waiting: Processing or awaiting input
- š“ Error: Something went wrong
Agent Activity
- See which agent is currently active
- View real-time progress updates
- Monitor decision-making process
Settings Panel
LLM Configuration
- Add/edit API keys
- Select models for each agent
- Test connectivity
General Settings
- Adjust automation speed
- Enable/disable features
- Manage conversation history
Best Practices
1. Be Specific
ā "Find a speaker" ā "Find portable Bluetooth speakers on Amazon under $50 with at least 10-hour battery life"
2. Break Down Complex Tasks
Instead of one mega-task, use follow-up questions:
- "Go to Product Hunt and find today's top product"
- "Tell me more about its features"
- "Visit their website and get pricing information"
3. Use Natural Language
Write as if you're talking to a human assistant. OnPiste understands context and nuance.
4. Check Agent Progress
Watch the status updates to understand what the agents are doing and when they might need guidance.
Common Tasks
Web Research
Research [topic] and provide key points from the top 3 sources
Price Monitoring
Check the price of [product] on [website] and let me know if it's under [amount]
Data Extraction
Go to [website] and extract all email addresses from the contact page
Text Input Automation
Enter [text] in the search field and submit
Optimizing Performance
Model Selection
Best Performance
- Planner: Claude Sonnet 4
- Navigator: Claude Haiku 3.5
Cost-Effective
- Planner: GPT-4o or Claude Haiku
- Navigator: Gemini 2.5 Flash or GPT-4o-mini
Zero Cost (Local)
- Both: Qwen3-30B or Falcon3 10B via Ollama
Tips for Local Models
When using Ollama or local models:
- Use more specific, cleaner prompts
- Avoid high-level ambiguous commands
- Break tasks into clear, detailed steps
- Provide explicit context and constraints
Troubleshooting
Task Failed
- Check if API keys are valid
- Try a simpler version of the task
- Check console for error messages
Slow Performance
- Use faster models for the Navigator
- Break complex tasks into smaller steps
- Check your internet connection
Wrong Results
- Be more specific in your prompt
- Add constraints and context
- Use follow-up questions to refine
Next Steps
- Learn about LLM Configuration
- Understand the Multi-Agent System
- Explore Advanced Features
- Join our Discord Community
Need Help?
- Discord: Get help from the community
- GitHub: Report bugs or request features
- FAQ: Check common questions and answers
