Metadata-Version: 2.4
Name: pullnexus
Version: 0.1.0
Summary: Pull from the Nexus. Give back to the Nexus. Keep local AI smart.
Project-URL: Homepage, https://github.com/MRWillisT/PullNexus
Project-URL: Repository, https://github.com/MRWillisT/PullNexus
Project-URL: Issues, https://github.com/MRWillisT/PullNexus/issues
License: MIT
License-File: LICENSE
Keywords: llm,local-ai,mcp,ollama,rag,skills
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: httpx>=0.28
Requires-Dist: packaging>=24
Requires-Dist: rich>=14
Requires-Dist: typer[all]>=0.15
Description-Content-Type: text/markdown

# PullNexus
**Tagline:** Your local AI shouldn't have to be dumb. Pull skills, tools, and knowledge on demand â€” free, open, community-built.

---

## 1. Vision (Elevator Pitch)

Local LLMs are powerful but isolated. They forget niche expertise, hallucinate on specifics, and keep reinventing the wheel.

PullNexus is a living, open commons where anyone contributes high-quality skills, tools, curated conversations, JSONL training data, or prompt packs. Your local model (Ollama, LM Studio, etc.) hits a wall â†’ queries PullNexus â†’ instantly pulls the exact skill it needs â†’ levels up on the fly.

No subscriptions. No corporate gatekeeping. Just Wikipedia + Hugging Face + npm, built for local AI brains.

---

## 2. Why Now

The timing is perfect:

- **Ollama** crossed massive mainstream adoption (tens of millions of downloads) â€” local AI is no longer niche.
- **Affordable hardware is here:** RTX 5060 Ti just launched, making strong VRAM setups realistic for regular users.
- **Growing backlash** against API pricing and paywalls is pushing more people toward fully local setups.
- **The "AI skills" ecosystem is exploding**, but there's still no general-purpose, community-owned, pull-on-demand registry for everyday local models.
- **HuggingFace is a great data warehouse. OpenSkills is closed. Agent toolkits are provider-specific.** None of them are local-first, pull-on-demand, and community-owned.

This isn't coincidence â€” it's a real window to build the missing infrastructure layer.

---

## 3. How It Works

1. Community submits skills via GitHub PRs or a simple web form.
2. Skills are versioned, rated, and tagged.
3. Local client / CLI / MCP integration:
   ```
   pullnexus search rust debugger
   pullnexus install rust-memory-leak
   ```
4. Model loads it into context or as a tool and gets smarter immediately.
5. You improve it â†’ submit v2 â†’ everyone benefits.

### The Contributor Loop (Our Unfair Advantage)

Use your real conversations with local models â†’ run them through your JSONL pipeline â†’ auto-generate high-quality training data â†’ submit back to the commons. Real usage becomes new skills. This closes the loop beautifully and makes contribution nearly effortless. No other project in this space has this.

---

## 4. What a Skill Actually Looks Like

Here's the folder structure for a skill â€” this is what people submit:

```
skills/python-advanced-debugging/
â”œâ”€â”€ skill.json          â† Metadata (name, description, tags, version, license)
â”œâ”€â”€ examples.jsonl      â† JSONL conversation pairs (the real training meat)
â”œâ”€â”€ README.md           â† Human-readable explanation + usage instructions
â”œâ”€â”€ eval.jsonl          â† Test cases to verify the skill works well
â””â”€â”€ tools/              â† Optional MCP tool definitions
```

**Example skill.json:**
```json
{
  "name": "python-advanced-debugging",
  "version": "1.2.0",
  "description": "Expert techniques for memory leaks, pdb, and tracing in Python",
  "tags": ["python", "debugging", "development"],
  "license": "CC0-1.0",
  "evaluation_cases": 12,
  "mcp_compatible": true
}
```

This "show, don't tell" structure makes it dead simple for any developer to contribute.

---

## 5. Core Features

### MVP (Ship First)
- Standardized skill format (JSONL + Markdown as the core spec)
- GitHub-backed registry + simple web UI (GitHub Pages to start)
- CLI tool: `pullnexus pull`, `pullnexus search`, `pullnexus submit`
- Basic search, ratings, and versioning
- Ollama / LM Studio / MCP integration examples
- 5â€“10 seed skills live on day one

### Later
- Web search API for local models
- Automated quality scoring + evals
- Federated nodes (run your own mirror)
- Bounty board for missing skills
- Reputation system

---

## 6. Differentiation

This isn't another data dump. It's the **executable intelligence layer** missing from the open AI stack â€” discoverable, pullable skills designed specifically for local models.

| Platform | What It Is | What's Missing |
|---|---|---|
| HuggingFace | Data warehouse | Not pull-on-demand, not local-first |
| OpenSkills | Skills ecosystem | Closed, provider-specific |
| Agent toolkits | Tool calling frameworks | Not community-owned, not general-purpose |
| **PullNexus** | Living skill commons | **Nothing â€” this is it** |

---

## 7. Challenges & Mitigations

| Challenge | Mitigation |
|---|---|
| Quality | Stars, reviews, test cases, curation queue |
| Spam | GitHub workflow + signing |
| Incentives | Leaderboards, badges, PullNexus Hall of Fame |
| Legal | Clear CC0/MIT contribution license + provenance tracking |

---

## 8. Governance

PullNexus will start with a simple steering committee made up of founding contributors (top active people + initial maintainers). Major decisions â€” core registry policies, format changes â€” go through public discussion with voting weighted by contribution history. This keeps it community-driven while preventing hijacking or chaos. As it grows, it can evolve into a proper open source foundation structure.

---

## 9. Seed Skills (Day One Inventory)

These can be built directly from the existing JSONL pipeline before launch â€” no extra work needed:

1. `autonomous-agent-patterns` â€” planning, tool orchestration, memory loops
2. `python-advanced-debugging` â€” memory leaks, pdb, tracing
3. `pytest-and-testing` â€” test structure, fixtures, coverage
4. `vibe-coder-workflow` â€” idea to working code, full loop
5. `reasoning-and-problem-solving` â€” breaking down complex problems
6. `code-refactoring` â€” cleanup, modularization, readability
7. `crypto-trading-bot` â€” strategy logic, backtesting, bot architecture
8. `n8n-mcp-workflows` â€” MCP-native n8n automation patterns
9. `autonomous-agent-payments` â€” x402-style payment and policy guardrails

These aren't placeholders â€” they're real, battle-tested conversations already in JSONL format. That's the head start no other project launching in this space has.

---

## 10. Launch Plan (Next 30â€“60 Days)

| Week | Action |
|---|---|
| **Week 1** | Lock everything â€” GitHub org (`pullnexus`), PyPI package, domain (`pullnexus.dev` or `pullnexus.io`) |
| **Week 1** | Convert 9 seed skills from existing JSONL pipeline/community patterns into the skill format |
| **Week 2** | Write the full spec doc + contribution guide |
| **Week 2** | Build basic CLI in Python (`pull`, `search`, `submit`) |
| **Week 3** | GitHub Pages landing page + registry structure |
| **Week 4** | Polish README, record a 2-min demo |
| **Day 30** | Launch post on r/LocalLLaMA, r/MachineLearning, HuggingFace, X/Twitter |
| **Ongoing** | Reach out to Ollama, LM Studio, Continue.dev communities for collaboration |

> âš¡ **Do today:** Register `pullnexus` on PyPI and grab the domain. GitHub org is done â€” finish locking the name everywhere else before posting publicly.

---

## 11. About the Founder

PullNexus was conceived by a vibe coder who spent a year and a half building real AI-assisted projects, got fed up with paywalls and pricing changes, and decided to build the infrastructure that should have existed already. The JSONL pipeline powering PullNexus's contribution format was built and battle-tested on real projects before this project existed â€” meaning the tooling isn't theoretical, it works.

---

*PullNexus â€” Pull from the Nexus. Give back to the Nexus. Keep local AI smart.*
