-
Notifications
You must be signed in to change notification settings - Fork 0
Quick Start
Dragon edited this page Dec 22, 2025
·
3 revisions
# ⚡ Quick Start Guide
Welcome to NaviDuck! This guide will get you up and running in **5 minutes or less**. Perfect for your first time using NaviDuck.
## 🎯 In This Guide
- First launch and setup
- Your first search
- Chatting with NavAI
- Essential commands
- Next steps
---
## 🚀 1-Minute Launch
Already installed NaviDuck? Just run:
```bash
python naviduck.pyYou'll see the main screen:
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ NaviDuck Browser - Enhanced Version ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
🔍 Default Engine: Brave Search
🧅 Tor: OFF
🕰️ History: 0 entries
📑 Bookmarks: 0 saved
🤖 NavAI: Ready
⚙️ Icons: Nerd Font
Type a command (try 'ai hello' or 's python'):
🎉 Congratulations! You're in!
Type this at the prompt:
ai helloYou'll get a friendly response from NavAI - your built-in AI assistant!
Try searching for something:
s python programmingor
search wikipedia artificial intelligenceAfter searching, you'll see numbered results. Type a number to open it:
Select an option:
1-10 - Open result in NaviDuck
o1-o10 - Open result in browser
b - Bookmark first result
Enter - Return to search
Your choice: 1
Back at the main prompt, try these:
help # See all commands
history # View your search history
settings # Open settings menu
clear # Clear the screengo example.comThis will load the website content right in your terminal!
| Command | What it does | Example |
|---|---|---|
s [query] |
Quick search | s python tutorial |
search [engine] [query] |
Search with specific engine | search google cats |
go [url] |
Visit a website | go github.com |
open [url/#] |
Open in system browser |
open 1 (opens 1st result) |
back |
Go back | back |
forward |
Go forward | forward |
| Command | What it does | Example |
|---|---|---|
ai [question] |
Ask NavAI anything | ai what is python |
help |
Show help menu | help |
clear |
Clear screen | clear |
| Command | What it does | Example |
|---|---|---|
history |
Show browsing history | history |
bookmarks |
Show bookmarks | bookmarks |
settings |
Open settings | settings |
| Command | What it does | Example |
|---|---|---|
tor start |
Start Tor | tor start |
tor stop |
Stop Tor | tor stop |
quit |
Exit NaviDuck | quit |
^X |
Exit immediately |
^X (Ctrl+X) |
Complete these 7 tasks to become a NaviDuck pro:
- Launch NaviDuck
- Say hello to NavAI:
ai hello - Search for your favorite programming language
- Open a search result
- Use
helpcommand
- Visit a website:
go example.com - Open a website in your system browser:
open github.com - Bookmark a page (press
bwhen viewing a page) - View your history:
history
- Change search engine in settings
- Toggle between emoji and icon mode
- Start Tor:
tor start - Search Wikipedia specifically:
search wikipedia [topic]
Reward: You're now a NaviDuck power user! 🎉
# Search with different engines
s python # Uses default engine
search google python # Use Google specifically
search wikipedia ai # Search Wikipedia
search brave programming # Use Brave Search
# Direct questions to AI
ai what is machine learning
ai current time
ai who created pythonWhen you see search results:
1. 🔍 Python Official Website - python.org
2. 🔍 Python Tutorial - w3schools.com/python
3. 🔍 Learn Python - Free Interactive Python Tutorial
- Type
1to open in NaviDuck - Type
o1to open in your system browser - Type
bto bookmark the first result
NavAI can answer questions by searching the web. Try these:
ai what is the capital of france
ai who invented the internet
ai how tall is mount everestai what is python used for
ai explain machine learning
ai how to install python on windowsai tell me a joke
ai what is the meaning of life
ai roll a dice
ai flip a coinai current time
ai what is the weather
ai how to code a website- Run
settings - Choose option
1to change default search engine - Pick your favorite (Brave is good to avoid CAPTCHAs)
- Choose option
3to toggle icons if you prefer emoji
# Change default engine to Google
# (Go to settings, option 1)
# Switch to emoji mode for better compatibility
# (Go to settings, option 3)
# Enable/disable search engines
# (Go to settings, option 2, then "enable 1", "disable 2", etc.)Stuck? Try these:
help # Shows all commands
ai help # Ask NavAI for help# Try a different engine
search google your query
search brave your query
# Or ask the AI instead
ai your question herequit # Graceful exit
^X # Immediate exit (Ctrl+X)clear # Clears everything- Launch NaviDuck
- Try
ai hello - Try
s test - Browse results
- Open a website:
go example.com - View history:
history - Bookmark a page
- Open
settings - Change default search engine
- Toggle icon style
- Try
tor start - Search Wikipedia:
search wikipedia cats - Ask complex AI questions
- Use
Ctrl+Xto quit quickly - Install a Nerd Font for better icons
- Consider using Windows Terminal
- Use
Cmd+Cto copy from terminal - Install iTerm2 for better experience
- Try
brew install torfor Tor support
- Use
Tabfor command completion - Install
gnureadlinefor better editing - Tor is usually
sudo apt install tor
# 1. Search for topic
s machine learning
# 2. Ask AI for explanation
ai explain machine learning
# 3. Visit relevant site
go towardsdatascience.com
# 4. Bookmark useful page
# (Press 'b' when viewing page)# 1. Look up documentation
s python requests module
# 2. Get code example
ai show me python requests example
# 3. Open GitHub repo
open github.com/psf/requests# 1. Check tech news
s latest tech news
# 2. Get specific info
ai what is new in python 3.11
# 3. Visit news site
go hackernews.comNaviDuck automatically switches engines when it detects CAPTCHA. If you see one:
- Wait a moment - it will switch automatically
- Or manually switch engines:
search brave your_query
# Try different engine
search google your_query
# Or use AI instead
ai your_question# Try broader search
s python # Instead of s python advanced decorators
# Try different engine
search wikipedia your_topic
# Ask AI
ai information about your_topic- ✅ Complete this Quick Start guide
- Try all basic commands
- Bookmark 3 useful pages
- Use NaviDuck for daily searches
- Experiment with different engines
- Customize your settings
- Integrate NaviDuck into your workflow
- Use Tor for sensitive searches
- Contribute to the project!
You've completed the Quick Start! Here's what to explore next:
- Search Guide - Master searching with NaviDuck
- AI Assistant Guide - Get the most from NavAI
- Settings & Configuration - Customize NaviDuck to your needs
- Keyboard Shortcuts - Work faster with hotkeys
- Troubleshooting - Solve common problems
You've learned how to:
- ✅ Launch and navigate NaviDuck
- ✅ Search the web efficiently
- ✅ Use the AI assistant
- ✅ Manage bookmarks and history
- ✅ Customize settings
- ✅ Exit properly
You're ready to explore the web from your terminal! 🦆💻
- Check the FAQ for common questions
- Visit Discussions to ask the community
- Review Basic Commands for command reference
- Read Troubleshooting for solutions
"The best way to learn is by doing. Try a command now!"
# Your turn! Try one of these:
ai what can you do?
s something interesting
go wikipedia.orgHappy browsing! 🎉
Last updated: 12/22/2025
Quick Start version: 1.1
This Quick Start Guide is designed to get users productive with NaviDuck in minutes. It includes:
1. Immediate actionable steps
2. Essential command cheat sheets
3. Progressive challenges
4. Platform-specific tips
5. Common workflows
6. Clear next steps
Perfect for new users who want to start using NaviDuck immediately!