ALwrity Deep Researcher for content generation

Smarter, Deeper Web Research Using Tavily AI & Metaphor AI

🧠 What Is It?

ALwrity AI Web Researcher is your intelligent research assistant that digs through the internet using smart AI tools—Tavily AI and Metaphor/Exa AI—to help you find the best information, fast. Instead of you manually browsing dozens of pages, this tool gathers and summarizes the most relevant and trustworthy information in just a few clicks.

Whether you're a content creator, student, journalist, or entrepreneur—this tool is designed to make your life easier by combining AI-powered search with simple, customizable controls.

Install ALwrity Content generation platform for AI web researcher

🚀 What Can It Do?

🔍 Smarter Searches with Two Powerful AIs

• Tavily AI Search

  • Understands your query in-depth, even if it's complex.

  • Pulls insights from across the web, tailored to your needs.

  • Gives you easy-to-read summaries.

  • Suggests follow-up questions you might not have thought of.

  • Lets you focus on certain topics or industries.

    
    

• Metaphor AI Search

  • Thinks like a human—understands meaning, not just keywords.

  • Finds hidden gems and relevant content using neural networks.

  • Spots patterns in information to connect related ideas.

  • Ranks results by how useful they are to your original question.

---

🧭 Search Modes for Different Needs

• Google Mode: Familiar Google-like search with smart AI summaries.

• AI Mode: A blend of Tavily + Metaphor to deliver more intelligent results.

• Deep Mode: Uses everything together for the most thorough research possible.

---

🔧 Customize Your Search (Advanced Settings)

You don’t need to be a techie! With easy options, you can:

• Set how deep the research should go (1 to 5).

• Choose which region you want results from (e.g., US, UK, India).

• Pick results from specific time ranges (like past week, month, year).

• Include or block websites (e.g., only show results from academic domains).

• Choose your language.

• Set how many results you want.

---

🛠️ How to Set It Up

No coding experience? No worries—just follow these steps. ALwrity supports both & More

✅ Step 1: Install It

Make sure you have Python installed (free from python.org). Then run these commands in your terminal:

git clone https://github.com/yourusername/ai-web-researcher.git
cd ai-web-researcher
pip install -r requirements.txt

Or install individual packages if needed:

pip install tavily-python metaphor-python streamlit python-dotenv

---

✅ Step 2: Add Your API Keys

Sign up for Tavily and Metaphor to get your free API keys. Then, create a .env file and paste:

TAVILY_API_KEY=your_tavily_api_key
METAPHOR_API_KEY=your_metaphor_api_key

✅ Step 3: Configure (Optional)

You can tweak things like:

• Default search filters.

• Preferred websites to search from.

• Languages and depth preferences.

All of this lives in a file called config.yaml.

---

🔎 How to Use It (Super Easy)

1. Start the app by typing:

   streamlit run app.py

2. Enter your search phrase (e.g., “Top marketing trends 2025”).

3. Choose your search mode (Google / AI / Deep).

4. Hit Start Research and let AI do the heavy lifting!

5. Explore smart summaries, suggested follow-ups, and preview the sources directly.

You can also fine-tune your results using the advanced options we mentioned above.

---

🧬 How It Works (Simplified) Behind the Scenes with Tavily AI

• Finds answers using smart algorithms.

• Summarizes content automatically.

• Helps you ask better follow-up questions.

• Filters out irrelevant websites.

• Lets you focus on specific industries.

  
  

What Metaphor AI Adds

• Searches by meaning—not just words.

• Understands the why behind your question.

• Finds related content even if it uses different language.

• Scores how helpful each result is.

---

📊 How Results Are Displayed

• See everything in a clean, clickable table.

• Get quick previews before visiting the site.

• AI-generated answers are clearly highlighted.

• Smart follow-up questions appear as helpful suggestions.

👨‍💻 Developer’s Corner (for Tech-Savvy Users)

Tavily API Example

client.search(
    query="your_query",
    search_depth="advanced",
    time_range="year",
    include_answer="advanced",
    include_domains=["example.com"]
)

Metaphor API Example

client.search(
    query="your_query",
    num_results=10,
    include_domains=["example.com"]
)

✅ Tips for Best Results

• Use specific keywords like “eco-friendly travel gadgets 2024” instead of “travel stuff.”

• Combine terms like “marketing” + “AI tools” for better matches.

• Explore follow-up questions for deeper research.

• Cross-check multiple sources before drawing conclusions.

---

🛠 Troubleshooting

Problem: “Invalid API key”✅ Solution: Double-check your .env file and API dashboard.

Problem: “No results or app crashes”✅ Solution: Make sure you’re connected to the internet and your filters aren’t too strict.

Problem: “Weird display or broken page”✅ Solution: Clear your browser cache or update Streamlit.

🤝 Contributing to This Project

Want to add a feature or fix something?

1. Fork the project on GitHub

2. Create a new branch

3. Make your changes

4. Push your branch

5. Open a Pull Request

   
   

📜 License

This project is open source under the MIT License—free to use and modify.

💬 Need Help?

• Ask questions on GitHub Issues

• Check the Wiki documentation

• Join the community forum

  
  

🌟 What’s Coming Next?

• Support for more AI search engines

• Better graphs and visual tools

• Custom AI models for niche topics

• Easier export and sharing

• Batch research mode (upload a list of queries)

Let AI Web Researcher become your secret weapon for smarter, faster, and better research—without the overwhelm.