mirror of
https://github.com/Shubhamsaboo/awesome-llm-apps.git
synced 2026-08-28 19:11:53 +08:00
docs: remove broken references to nonexistent files in app READMEs
Strip the remaining broken local links whose targets don't exist in the repo, and tidy the surrounding content so nothing reads as dangling: - ai_self_evolving_agent: drop vendored EvoAgentX ./docs/* pointers (install guide, LLM guide, quickstart, tutorial table) and the broken ./LICENSE link (kept the plain "MIT License" statement) - ai-mcp-app-builder: remove all docs/* links (TRACKER, HANDOFF, PLAN, DEPLOY-RENDER, DYNAMIC_MCP, E2B-IMPLEMENTATION) — that docs/ folder was never included — plus the now-empty "In this repo" block; kept valid UI-entry and External links - web_scraping_ai_agent: drop two links to a missing scrapegraph_ai_sdk/ README (kept the upstream GitHub + API doc links) - windows_use_autonomous_agent: remove README-level License and Contributing sections (no LICENSE/CONTRIBUTING files present) - thinkpath_chatbot_app: remove missing demo.gif image (video block kept) Repo-wide broken local-link count is now 0 (down from 68 originally). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -75,8 +75,6 @@ We recommend installing EvoAgentX using `pip`:
|
||||
pip install git+https://github.com/EvoAgentX/EvoAgentX.git
|
||||
```
|
||||
|
||||
For local development or detailed setup (e.g., using conda), refer to the [Installation Guide for EvoAgentX](./docs/installation.md).
|
||||
|
||||
<details>
|
||||
<summary>Example (optional, for local development):</summary>
|
||||
|
||||
@@ -169,8 +167,6 @@ llm = OpenAILLM(config=openai_config)
|
||||
# Generate a response from the LLM
|
||||
response = llm.generate(prompt="What is Agentic Workflow?")
|
||||
```
|
||||
> 📖 More details on supported models and config options: [LLM module guide](./docs/modules/llm.md).
|
||||
|
||||
|
||||
## Automatic WorkFlow Generation
|
||||
Once your API key and language model are configured, you can automatically generate and execute multi-agent workflows in EvoAgentX.
|
||||
@@ -278,23 +274,6 @@ We apply EvoAgentX to optimize their prompts. The performance of the optimized a
|
||||
|
||||
## Tutorial and Use Cases
|
||||
|
||||
> 💡 **New to EvoAgentX?** Start with the [Quickstart Guide](./docs/quickstart.md) for a step-by-step introduction.
|
||||
|
||||
|
||||
Explore how to effectively use EvoAgentX with the following resources:
|
||||
|
||||
| Cookbook | Description |
|
||||
|:---|:---|
|
||||
| **[Build Your First Agent](./docs/tutorial/first_agent.md)** | Quickly create and manage agents with multi-action capabilities. |
|
||||
| **[Build Your First Workflow](./docs/tutorial/first_workflow.md)** | Learn to build collaborative workflows with multiple agents. |
|
||||
| **[Automatic Workflow Generation](./docs/quickstart.md#automatic-workflow-generation-and-execution)** | Automatically generate workflows from natural language goals. |
|
||||
| **[Benchmark and Evaluation Tutorial](./docs/tutorial/benchmark_and_evaluation.md)** | Evaluate agent performance using benchmark datasets. |
|
||||
| **[TextGrad Optimizer Tutorial](./docs/tutorial/textgrad_optimizer.md)** | Automatically optimise the prompts within multi-agent workflow with TextGrad. |
|
||||
| **[AFlow Optimizer Tutorial](./docs/tutorial/aflow_optimizer.md)** | Automatically optimise both the prompts and structure of multi-agent workflow with AFlow. |
|
||||
<!-- | **[SEW Optimizer Tutorial](./docs/tutorial/sew_optimizer.md)** | Create SEW (Self-Evolving Workflows) to enhance agent systems. | -->
|
||||
|
||||
🛠️ Follow the tutorials to build and optimize your EvoAgentX workflows.
|
||||
|
||||
🚀 We're actively working on expanding our library of use cases and optimization strategies. **More coming soon — stay tuned!**
|
||||
|
||||
## 🎯 Roadmap
|
||||
@@ -341,4 +320,4 @@ This project builds upon several outstanding open-source projects: [AFlow](https
|
||||
|
||||
## 📄 License
|
||||
|
||||
Source code in this repository is made available under the [MIT License](./LICENSE).
|
||||
Source code in this repository is made available under the MIT License.
|
||||
|
||||
@@ -116,14 +116,6 @@ Talk to your computer. Watch it get things done.
|
||||
|
||||
Agent interacts directly with your Windows OS at GUI layer to perform actions. While the agent is designed to act intelligently and safely, it can make mistakes that might bring undesired system behaviour or cause unintended changes. Try to run the agent in a sandbox envirnoment.
|
||||
|
||||
## 🪪 License
|
||||
|
||||
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
Contributions are welcome! Please check the [CONTRIBUTING](CONTRIBUTING) file for setup and development workflow.
|
||||
|
||||
Made with ❤️ by [Jeomon George](https://github.com/Jeomon)
|
||||
|
||||
---
|
||||
|
||||
@@ -11,7 +11,6 @@
|
||||
|
||||
ThinkPath AI revolutionizes how you interact with language models by introducing **guided thinking paths** - letting you control exactly how deep the AI goes into any topic, step by step.
|
||||
|
||||

|
||||
<video width="100%" controls>
|
||||
<source src="https://github.com/Ahmed-G-ElTaher/ThinkPath-Chatbot/blob/main/github%20thinkpath%20video.mp4" type="video/mp4">
|
||||
Your browser does not support the video tag.
|
||||
|
||||
@@ -4,8 +4,6 @@ Describe an MCP app in chat and get a live, sandboxed instance back. Built with
|
||||
|
||||
**Gen UI concept — agent-generated apps.** Most generative UI picks from a fixed catalogue of components. This goes a step further: the agent authors a brand-new MCP app at runtime, the builder provisions an E2B sandbox to host it, and the app renders inline with full bidirectional tool access. The "component" the agent emits *is a whole app*.
|
||||
|
||||
**Production go-live:** [`docs/TRACKER.md`](docs/TRACKER.md) · **Stakeholder / product handoff** (shipped scope, CopilotKit open questions): [`docs/HANDOFF.md`](docs/HANDOFF.md)
|
||||
|
||||
This monorepo wires up the **MCP App builder** web UI (`apps/web`) to a **Mastra** agent (`/api/mastra-agent`) that provisions **E2B** sandboxes running the **`mcp-use-server`** template (`apps/mcp-use-server`). An optional local sample is the [Three.js MCP example](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/threejs-server) in **`apps/threejs-server`** (used for sidebar defaults when running everything locally).
|
||||
|
||||
https://github.com/user-attachments/assets/4bb35806-5e42-43c0-a8fe-01c0d1e5b8b3
|
||||
@@ -57,7 +55,7 @@ Open the URL shown by Next (usually `http://localhost:3000`).
|
||||
| Script | Description |
|
||||
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `pnpm dev` | Next.js dev (Turbopack) |
|
||||
| `pnpm build` | Runs **`prebuild`** → **`pack-download-kit`** (writes **`.download-kit/base.tar.gz`** for [full app kit](docs/HANDOFF.md) download), then **`next build`** |
|
||||
| `pnpm build` | Runs **`prebuild`** → **`pack-download-kit`** (writes **`.download-kit/base.tar.gz`** for full app kit download), then **`next build`** |
|
||||
| `pnpm pack-download-kit` | Regenerate **`.download-kit/base.tar.gz`** without a full Next build |
|
||||
| `pnpm start` | Production Next server |
|
||||
| `pnpm lint` | ESLint |
|
||||
@@ -80,19 +78,19 @@ Requirements: **`E2B_API_KEY`** in `.env` (or environment). The CLI prints a **`
|
||||
|
||||
## Agent and UI
|
||||
|
||||
The app title is **MCP App builder** (subtitle **Powered by CopilotKit**), logo **`apps/web/app/image.png`**, agent route **`/api/mastra-agent`**. Header CTAs use **`NEXT_PUBLIC_HEADER_*`** (and **`NEXT_PUBLIC_GITHUB_REPO_URL`** for the secondary link; code default points at **this demo repo**). Chat starters: **`NEXT_PUBLIC_CHAT_STARTER_PROMPTS`** (JSON) or **three** built-in bounded demos — tic tac toe, tip calculator, dice roller (**[`docs/HANDOFF.md`](docs/HANDOFF.md)**). Reference CopilotKit route: **`apps/web/app/api/copilotkit/route.ts`**.
|
||||
The app title is **MCP App builder** (subtitle **Powered by CopilotKit**), logo **`apps/web/app/image.png`**, agent route **`/api/mastra-agent`**. Header CTAs use **`NEXT_PUBLIC_HEADER_*`** (and **`NEXT_PUBLIC_GITHUB_REPO_URL`** for the secondary link; code default points at **this demo repo**). Chat starters: **`NEXT_PUBLIC_CHAT_STARTER_PROMPTS`** (JSON) or **three** built-in bounded demos — tic tac toe, tip calculator, dice roller. Reference CopilotKit route: **`apps/web/app/api/copilotkit/route.ts`**.
|
||||
|
||||
**Starter prompts** use **`useCopilotChatSuggestions`** (`ChatSuggestions.tsx`) with v2 **`CopilotChat`**.
|
||||
|
||||
**Post-provision test chips:** frontend action **`show_mcp_test_prompts`** (`McpTestPromptsAction.tsx`) — JSON string of `{ label, message }[]` for clickable chips (**`appendMessage`**).
|
||||
|
||||
**Download:** **`restart_server`** / sidebar download can return a **full app kit** (`.tar.gz`): E2B workspace merged into **`mcp-apps-starter/`** when **`apps/web/.download-kit/base.tar.gz`** exists (created by **`pnpm build`** / **`prebuild`** in `apps/web`). Otherwise download is **MCP-only**. Details: **`docs/HANDOFF.md`**.
|
||||
**Download:** **`restart_server`** / sidebar download can return a **full app kit** (`.tar.gz`): E2B workspace merged into **`mcp-apps-starter/`** when **`apps/web/.download-kit/base.tar.gz`** exists (created by **`pnpm build`** / **`prebuild`** in `apps/web`). Otherwise download is **MCP-only**.
|
||||
|
||||
**Debug agent traffic:** set **`MASTRA_AGENT_DEBUG=1`** in `.env` for verbose **`/api/mastra-agent`** logs (see `.env.example`).
|
||||
|
||||
### Duplicate React keys (Mastra agent) — RCA and fix
|
||||
|
||||
Mastra can reuse the same `messageId` for tool-call parents and text events; CopilotKit then collides keys. **`mastra-agent/route.ts`** remaps ids when collisions are detected — see **`docs/HANDOFF.md`** / inline comments.
|
||||
Mastra can reuse the same `messageId` for tool-call parents and text events; CopilotKit then collides keys. **`mastra-agent/route.ts`** remaps ids when collisions are detected — see inline comments.
|
||||
|
||||
## Dynamic MCP UI (sidebar)
|
||||
|
||||
@@ -100,8 +98,6 @@ Mastra can reuse the same `messageId` for tool-call parents and text events; Cop
|
||||
- **Tools:** compact list; open a tool for **detail + preview** in a **modal** (not a third mobile tab).
|
||||
- **Chat:** CopilotKit v2 chat with suggestions.
|
||||
|
||||
More: **[`docs/DYNAMIC_MCP.md`](docs/DYNAMIC_MCP.md)**.
|
||||
|
||||
### Mobile layout
|
||||
|
||||
- **Tabs:** **Chat** and **Tools** (servers + tool list). Tool **preview / detail** opens in a **modal**.
|
||||
@@ -123,7 +119,7 @@ More: **[`docs/DYNAMIC_MCP.md`](docs/DYNAMIC_MCP.md)**.
|
||||
3. Set secret env vars in the dashboard: at least **`OPENAI_API_KEY`**; for sandboxes add **`E2B_API_KEY`** + **`E2B_TEMPLATE`**.
|
||||
4. Deploy. The Blueprint configures build/start commands, `NODE_VERSION`, and `HOSTNAME` automatically.
|
||||
|
||||
Render runs a long-lived Node.js process (not serverless), so there are no per-function timeout limits. See **[`docs/DEPLOY-RENDER.md`](docs/DEPLOY-RENDER.md)** for full setup, env var tables, and troubleshooting.
|
||||
Render runs a long-lived Node.js process (not serverless), so there are no per-function timeout limits.
|
||||
|
||||
### Agent tool pattern (sidebar preview)
|
||||
|
||||
@@ -131,14 +127,6 @@ Widget tools should include **`_meta["ui/previewData"]`** for offline sidebar pr
|
||||
|
||||
## Documentation
|
||||
|
||||
**In this repo**
|
||||
|
||||
- **[`docs/TRACKER.md`](docs/TRACKER.md)** — **production go-live checklist**
|
||||
- **[`docs/HANDOFF.md`](docs/HANDOFF.md)** — shipped scope, CopilotKit open questions
|
||||
- **[`docs/DEPLOY-RENDER.md`](docs/DEPLOY-RENDER.md)** — Render deployment guide
|
||||
- **[`docs/DYNAMIC_MCP.md`](docs/DYNAMIC_MCP.md)** — dynamic MCP patterns
|
||||
- **[`docs/PLAN.md`](docs/PLAN.md)** / **[`docs/E2B-IMPLEMENTATION.md`](docs/E2B-IMPLEMENTATION.md)** — roadmap and E2B design
|
||||
|
||||
**UI entry:** `apps/web/app/page.tsx` (theme, layout, CopilotKit wiring).
|
||||
|
||||
**External**
|
||||
|
||||
@@ -58,8 +58,6 @@ export SGAI_API_KEY='your-api-key'
|
||||
python quickstart.py
|
||||
```
|
||||
|
||||
**📖 Full Documentation**: [See scrapegraph_ai_sdk/README.md](scrapegraph_ai_sdk/README.md)
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Getting Started
|
||||
@@ -230,7 +228,6 @@ request_id = client.smartcrawler(
|
||||
## 📖 Documentation
|
||||
|
||||
- **Local Library**: [ScrapeGraphAI GitHub](https://github.com/VinciGit00/Scrapegraph-ai)
|
||||
- **Cloud SDK**: [See scrapegraph_ai_sdk/README.md](scrapegraph_ai_sdk/README.md)
|
||||
- **API Docs**: https://docs.scrapegraphai.com
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user