pythinker-code 2.0.0__py3-none-any.whl

pythinker_code-2.0.0.dist-info/METADATA

@@ -0,0 +1,660 @@
+Metadata-Version: 2.4
+Name: pythinker-code
+Version: 2.0.0
+Summary: Pythinker Code is your next CLI agent.
+Keywords: cli,agent,ai,coding-assistant,llm,claude,openai,terminal
+Author: Mohamed Elkholy
+Author-email: Mohamed Elkholy <moelkholy1995@gmail.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Requires-Dist: agent-client-protocol==0.8.0
+Requires-Dist: aiofiles>=24.0,<26.0
+Requires-Dist: aiohttp==3.13.3
+Requires-Dist: typer==0.21.1
+Requires-Dist: pythinker-core[contrib]==1.0.0
+Requires-Dist: loguru>=0.6.0,<0.7
+Requires-Dist: prompt-toolkit==3.0.52
+Requires-Dist: pillow==12.1.0
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: rich==14.2.0
+Requires-Dist: ripgrepy==2.2.0
+Requires-Dist: streamingjson==0.0.5
+Requires-Dist: trafilatura==2.0.0
+Requires-Dist: lxml==6.0.2
+Requires-Dist: tenacity==9.1.2
+Requires-Dist: fastmcp==2.12.5
+Requires-Dist: pydantic==2.12.5
+Requires-Dist: httpx[socks]==0.28.1
+Requires-Dist: pythinker-host==1.0.0
+Requires-Dist: batrachian-toad==0.5.23 ; python_full_version >= '3.14'
+Requires-Dist: tomlkit==0.14.0
+Requires-Dist: jinja2==3.1.6
+Requires-Dist: pyobjc-framework-cocoa>=12.1 ; sys_platform == 'darwin'
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn[standard]>=0.32.0
+Requires-Dist: scalar-fastapi>=1.8.2
+Requires-Dist: websockets>=14.0
+Requires-Dist: keyring>=25.7.0
+Requires-Dist: setproctitle>=1.3.0
+Requires-Dist: sentry-sdk>=2.20,<3
+Requires-Dist: opentelemetry-api>=1.30,<2
+Requires-Dist: opentelemetry-sdk>=1.30,<2
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.30,<2
+Requires-Python: >=3.12
+Project-URL: Changelog, https://github.com/mohamed-elkholy95/Pythinker-Code/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/mohamed-elkholy95/Pythinker-Code#readme
+Project-URL: Homepage, https://github.com/mohamed-elkholy95/Pythinker-Code
+Project-URL: Issues, https://github.com/mohamed-elkholy95/Pythinker-Code/issues
+Project-URL: Repository, https://github.com/mohamed-elkholy95/Pythinker-Code
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# <img src="./docs/media/logo.png" alt="Pythinker logo" width="42" align="top"> Pythinker Code
+
+### *Your terminal-native AI engineering agent.*
+
+**Read code. Edit files. Run commands. Search the web. Plug into your IDE.**
+**All from the shell you already live in.**
+
+<br />
+
+[![PyPI](https://img.shields.io/badge/pythinker--cli-v1.0.0-2563eb?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/pythinker-code/)
+[![Python](https://img.shields.io/badge/Python-3.12%2B-3776ab?style=for-the-badge&logo=python&logoColor=white)](pyproject.toml)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-16a34a.svg?style=for-the-badge)](LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/mohamed-elkholy95/Pythinker-Code/ci-pythinker-code.yml?label=CI&color=22c55e&style=for-the-badge&logo=githubactions&logoColor=white)](https://github.com/mohamed-elkholy95/Pythinker-Code/actions/workflows/ci-pythinker-code.yml)
+
+[![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-f59e0b.svg?style=flat-square&logo=ruff&logoColor=white)](https://docs.astral.sh/ruff/)
+[![ACP ready](https://img.shields.io/badge/ACP-ready-7c3aed.svg?style=flat-square)](https://github.com/agentclientprotocol/agent-client-protocol)
+[![MCP tools](https://img.shields.io/badge/MCP-tools-0891b2.svg?style=flat-square)](https://modelcontextprotocol.io/)
+[![Homepage](https://img.shields.io/badge/home-pythinker.com-ec4899.svg?style=flat-square)](https://pythinker.com)
+
+<br />
+
+<a href="https://pythinker.com">🌐 Website</a> &nbsp;·&nbsp;
+<a href="#-quick-start">⚡ Quick Start</a> &nbsp;·&nbsp;
+<a href="#-features">✨ Features</a> &nbsp;·&nbsp;
+<a href="#-ide-integration-via-acp">🧩 IDE Integration</a> &nbsp;·&nbsp;
+<a href="#-mcp-tooling">🔌 MCP</a> &nbsp;·&nbsp;
+<a href="#-privacy--telemetry">🔐 Privacy</a> &nbsp;·&nbsp;
+<a href="#-development">🛠️ Develop</a>
+
+<br /><br />
+
+<img src="./docs/media/pythinker-code.gif" alt="Pythinker Code terminal demo" width="860">
+
+</div>
+
+---
+
+## 💡 What is Pythinker?
+
+**Pythinker Code** is an open-source AI coding agent that lives in your terminal. Unlike chat-based assistants stuck behind a browser tab, Pythinker can **read your repo, edit files, run shell commands, browse the web, and call MCP tools** — all in a single iterative loop driven by the model of your choice.
+
+It speaks the [**Agent Client Protocol (ACP)**](https://github.com/agentclientprotocol/agent-client-protocol), so it slots cleanly into ACP-aware editors like Zed and JetBrains. It loads [**Model Context Protocol (MCP)**](https://modelcontextprotocol.io/) servers, so the same tools your other agents use just work. And it's hackable: subagents, skills, hooks, and plugins are all first-class extension points.
+
+> 🎯 **One agent, one shell, one workflow.** No tab-switching. No context loss. No magic.
+
+---
+
+## ✨ Features
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+### 🖥️ Terminal-First
+
+Plan, edit, run, and verify without leaving your shell. Every action is visible, scriptable, and auditable.
+
+</td>
+<td width="50%" valign="top">
+
+### ⚡ Shell Command Mode
+
+Press `Ctrl-X` to drop into a direct shell prompt inside the agent. Run commands, then snap back into AI mode with full context preserved.
+
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+
+### 🧩 ACP IDE Integration
+
+Run `pythinker acp` and any [Agent Client Protocol](https://github.com/agentclientprotocol/agent-client-protocol) editor — Zed, JetBrains, and more — gets a full Pythinker session inline.
+
+</td>
+<td width="50%" valign="top">
+
+### 🔌 MCP Tool Loading
+
+Manage stdio and HTTP MCP servers with `pythinker mcp`. OAuth-backed servers, persistent config, ad-hoc files — all supported.
+
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+
+### 🤖 Subagents & Skills
+
+Delegate focused work to built-in subagents. Load reusable instructions via `/skill:<name>` and bundled prompt flows via `/flow:<name>`.
+
+</td>
+<td width="50%" valign="top">
+
+### 🪝 Hooks & Plugins
+
+Observe or block tool execution with hook events. Install community extensions with `pythinker plugin`.
+
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+
+### 🌐 Web & Visualization UIs
+
+Optional web frontend and visualization frontend ship alongside the CLI for richer inspection workflows.
+
+</td>
+<td width="50%" valign="top">
+
+### 🤖 Bring Your Own Model
+
+Swap providers and models per-session: `--model openai/gpt-5.5`, hosted Pythinker models, or your own keys.
+
+</td>
+</tr>
+</table>
+
+> [!NOTE]
+> Built-in shell commands such as `cd` are not yet supported in shell command mode.
+
+<div align="center">
+<img src="./docs/media/shell-mode.gif" alt="Shell command mode demo" width="860">
+</div>
+
+---
+
+## ⚡ Quick Start
+
+### 🚀 One-off run with `uvx`
+
+```sh
+uvx pythinker-code
+```
+
+### 📦 Install as a uv tool
+
+```sh
+uv tool install pythinker-code
+pythinker
+```
+
+### 🔐 Authenticate (optional)
+
+For hosted Pythinker models or ACP terminal auth:
+
+```sh
+pythinker login
+```
+
+### 💬 Try it out
+
+```sh
+# Interactive session
+pythinker
+
+# One-shot prompt
+pythinker --prompt "summarize this repository and suggest the next test to add"
+
+# Pick a specific model
+pythinker --model openai/gpt-5.5
+
+# Inline config override
+pythinker --config '{"default_thinking": true}'
+```
+
+---
+
+## 🏠 Using Local Models (LM Studio & Ollama)
+
+Run Pythinker entirely on your own machine — no API key, no cloud. Pythinker speaks each runtime's OpenAI-compatible API, so tools, streaming, JSON mode, vision, and `reasoning_effort` all work the same as with hosted providers.
+
+### LM Studio
+
+**1. Set up LM Studio.**
+- Install [LM Studio](https://lmstudio.ai/) and download at least one chat model.
+- In the LM Studio app, open the model and **raise its Context Length** (gear icon → Context Length). See [Context length matters](#context-length-matters) below.
+- Start the server: **Developer → Status: Running** (or `lms server start --port 1234`).
+
+**2. Connect Pythinker.**
+```sh
+pythinker login --lm-studio
+```
+
+This auto-discovers every chat-capable model loaded in LM Studio, registers each as `lm-studio/<model-id>`, and picks the largest-context one as your default. Embedding models are filtered out.
+
+**3. Use it.**
+```sh
+# Default LM Studio model
+pythinker -p "explain quicksort"
+
+# Specific model
+pythinker -m lm-studio/qwen/qwen3-coder-next -p "write a python http server"
+
+# Interactive shell, then switch models with /model
+pythinker
+```
+
+**4. Disconnect.**
+```sh
+pythinker logout --lm-studio
+```
+
+### Ollama
+
+```sh
+# 1. start the server in one terminal
+ollama serve
+
+# 2. pull a model
+ollama pull llama3.1:8b
+
+# 3. connect Pythinker
+pythinker login --ollama
+
+# 4. use it
+pythinker -p "explain monad transformers"
+pythinker -m ollama/llama3.1:8b -p "..."
+pythinker logout --ollama
+```
+
+Discovery uses Ollama's `/api/tags` for the model list and `/api/show` per model to read the real context window.
+
+### Remote LM Studio / Ollama (LAN host or alternate port)
+
+```sh
+pythinker login --lm-studio --base-url http://192.168.1.10:1234/v1
+pythinker login --ollama    --base-url http://lan-box:11434/v1
+```
+
+The override is saved in your config and used by every subsequent run.
+
+### From inside the interactive shell
+
+The same wiring is available as slash commands:
+
+```
+/login lm-studio        # or  /login lmstudio  (no dash also accepted)
+/login ollama
+/logout lm-studio
+/logout ollama
+/login                  # opens a chooser; entries 9 and 10 are the local providers
+/model lm-studio/google/gemma-4-e4b   # switch model mid-session
+```
+
+### <a id="context-length-matters"></a>⚠️ Context length matters (a common gotcha)
+
+Pythinker's agent prompt — system instructions + tool schemas + skills + your message + recent history — is large. **Tens of thousands of tokens before you've even sent your first message.**
+
+LM Studio loads a model with a small default context window (often `4096`). If you start chatting against that, you'll see:
+
+```
+LLM provider error: Error: The number of tokens to keep from the initial
+prompt is greater than the context length (n_keep: 16690 >= n_ctx: 4096).
+```
+
+The shell now prints a friendly recovery hint when this happens, but **the cure is in LM Studio**:
+
+1. In LM Studio, open the model in the **Chat** tab and click the **gear/settings** icon (or **My Models → Edit**).
+2. Set **Context Length** to at least **`32768`**, and prefer **`131072`** if your VRAM allows. *Practical experience: 64k still triggers errors during longer sessions; 128k is a safer floor.*
+3. Reload the model (LM Studio prompts you).
+4. Restart Pythinker so it picks up the new state (`Ctrl+D` then `pythinker`, or `pythinker -r <session-id>` to resume).
+
+**Tip:** the bigger you set the context, the more VRAM the model uses. If you OOM, try a smaller quantization (e.g., Q4_K_M instead of Q8_0) or a smaller model variant.
+
+Ollama configures context per-request and Pythinker reads the model's max from `/api/show`, so this gotcha is mostly LM-Studio-specific.
+
+### VRAM-friendly model picks
+
+Local models vary wildly in memory use. Rough guide on a 16 GB GPU (e.g., RTX 5080 mobile):
+
+| Model size | Quant | Approx. VRAM | Fits 16 GB? |
+|------------|-------|--------------|-------------|
+| 2-4 B      | Q4-Q8 | 2-4 GB       | Yes, easily |
+| 7-8 B      | Q4    | 5-6 GB       | Yes |
+| 7-8 B      | Q8    | 8-9 GB       | Yes |
+| 13-14 B    | Q4    | 8-10 GB      | Yes |
+| 27-31 B    | Q4    | 17-20 GB     | Tight / no |
+| 27-31 B    | Q8    | 30-35 GB     | No |
+
+If LM Studio errors with `Failed to load model`, you've exceeded VRAM — pick a smaller model or lower-bit quantization.
+
+### Environment variables
+
+These override the defaults at both login and runtime:
+
+| Variable | Purpose |
+|----------|---------|
+| `LM_STUDIO_BASE_URL` | Override `http://localhost:1234/v1` |
+| `LM_STUDIO_API_KEY`  | Set if you've enabled token auth in LM Studio |
+| `OLLAMA_BASE_URL`    | Override `http://localhost:11434/v1` |
+| `OLLAMA_API_KEY`     | Rarely needed (Ollama is unauthenticated by default) |
+
+Example:
+```sh
+LM_STUDIO_BASE_URL=http://workstation.lan:1234/v1 pythinker -p "..."
+```
+
+### Refreshing the model list
+
+If you load/unload models in LM Studio (or `ollama pull/rm`), re-run login to refresh:
+
+```sh
+pythinker login --lm-studio    # or --ollama
+```
+
+(Pythinker intentionally does NOT auto-refresh local providers in the background — login owns that state, so manual edits to your config aren't silently overwritten.)
+
+---
+
+## 🧩 IDE Integration via ACP
+
+Pythinker speaks [**Agent Client Protocol**](https://github.com/agentclientprotocol/agent-client-protocol) natively. Point your ACP-compatible editor at `pythinker acp` and you get a multi-session agent server inside your IDE.
+
+<details>
+<summary><b>📝 Configuration for Zed / JetBrains</b></summary>
+
+```json
+{
+  "agent_servers": {
+    "Pythinker Code": {
+      "type": "custom",
+      "command": "pythinker",
+      "args": ["acp"],
+      "env": {}
+    }
+  }
+}
+```
+
+</details>
+
+The ACP server provides:
+
+| Capability | Description |
+|---|---|
+| 🔑 **Terminal auth** | `pythinker login` flow exposed to the IDE |
+| 📂 **Session listing & resume** | Pick up where you left off |
+| 🔄 **Hot model swap** | Change models for a running ACP session |
+
+<div align="center">
+<img src="./docs/media/acp-integration.gif" alt="ACP IDE integration demo" width="860">
+</div>
+
+---
+
+## 🔌 MCP Tooling
+
+Pythinker loads [Model Context Protocol](https://modelcontextprotocol.io/) tools from persistent config or ad-hoc files. Same tools, every agent — no rewriting.
+
+### 🛠️ Manage persistent MCP servers
+
+```sh
+# 🌐 Streamable HTTP server with API key
+pythinker mcp add --transport http context7 https://mcp.context7.com/mcp \
+  --header "CONTEXT7_API_KEY: ctx7sk-your-key"
+
+# 🔐 Streamable HTTP server with OAuth
+pythinker mcp add --transport http --auth oauth linear https://mcp.linear.app/mcp
+
+# 💻 stdio server
+pythinker mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest
+
+# 📋 List, authorize, test, and remove
+pythinker mcp list
+pythinker mcp auth linear
+pythinker mcp test chrome-devtools
+pythinker mcp remove chrome-devtools
+```
+
+### 📄 Use an ad-hoc MCP config file
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "url": "https://mcp.context7.com/mcp",
+      "headers": {
+        "CONTEXT7_API_KEY": "YOUR_API_KEY"
+      }
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    }
+  }
+}
+```
+
+```sh
+pythinker --mcp-config-file /path/to/mcp.json
+```
+
+---
+
+## 🧬 Extensibility
+
+Pythinker is a small, extensible runtime — not a monolith. Build on it.
+
+| Extension Point | What it does | Where to look |
+|---|---|---|
+| 🤖 **Agents & subagents** | YAML specs define tools, prompts, and built-in subagent types | `src/pythinker_code/agents/` |
+| 🎓 **Skills** | `/skill:<name>` loads reusable instructions on demand | bundled & user-defined |
+| 🌊 **Flows** | `/flow:<name>` executes bundled prompt flows | bundled & user-defined |
+| 🪝 **Hooks** | Observe or block tool execution; integrate policy or automation | hook events API |
+| 🧩 **Plugins** | Installable extension packages | `pythinker plugin` |
+
+---
+
+## 🏗️ Architecture
+
+<div align="center">
+<img src="./docs/media/Architecture.webp" alt="Pythinker Code architecture diagram" width="860">
+</div>
+
+---
+
+## 🔐 Privacy & Telemetry
+
+Pythinker is the **agent framework**, not the LLM. You bring your own API key
+(OpenAI, Anthropic, your local LM Studio model, etc.); your prompts and the
+model's responses go directly between your terminal and the model provider you
+configured. Pythinker never sees, stores, or forwards them.
+
+To improve the framework itself we collect a small amount of **diagnostic
+telemetry** about how the agent runs. It's strictly anonymous, never includes
+your prompts, model output, file contents, file paths, or any user-identifying
+data. Two channels:
+
+| Channel | What lands there | Endpoint |
+|---|---|---|
+| **Errors** (Sentry-protocol) | Unhandled exceptions and crash stack traces, with absolute paths above `site-packages/` rewritten to `<env>/` so home directories don't leak | `errors.pythinker.com` (self-hosted Bugsink) |
+| **Traces + structured logs** (OpenTelemetry) | Lifecycle events (`session_started`, `started`, `model_switch`), agent-loop spans (`pythinker.turn` / `pythinker.llm` / `pythinker.tool`), and per-event counters | `otel.pythinker.com` (self-hosted SigNoz) |
+
+### What we collect
+
+- **Lifecycle events**: session start, command-line flags actually used (booleans only), startup timing, model name (just the identifier, e.g. `claude-opus-4-7`), thinking-mode toggle, plan-mode toggle.
+- **Agent-loop spans**: turn duration, step count, stop reason (`no_tool_calls` / `max_steps` / `error`), tool name (`Read`, `Bash`, `Edit`, …), tool success/failure, tool duration, LLM call duration, input/output token *counts* (numbers — never the content).
+- **Crashes**: exception class name, scrubbed stack trace, library versions. We do **not** send local variable values.
+- **Static context**: pythinker version, OS family, Python version, terminal type (`TERM_PROGRAM`), CI flag (`CI` env var presence), locale.
+- **A persistent, random `device_id`** so we can count "how many distinct installs" without identifying a person.
+
+### What we never collect
+
+- Your prompts, the model's responses, or any conversation content
+- File contents, file paths, working directory names, or workspace structure
+- Your API keys, OAuth tokens, environment variables
+- Your real name, email, IP address, hostname (host name field is dropped at the edge collector)
+- Tool arguments (e.g. what file you read, what command you ran)
+
+### Opting out
+
+Pick whichever fits your workflow — all three are equivalent:
+
+```sh
+# 1. Per-invocation CLI flag
+pythinker --no-telemetry
+
+# 2. Environment variable (works in shells, .env files, CI configs)
+export PYTHINKER_DISABLE_TELEMETRY=1
+pythinker
+
+# 3. Permanently in your config file (~/.pythinker/config.toml)
+[default]
+telemetry = false
+```
+
+Setting any of these at startup short-circuits Sentry initialization, OTel
+exporter creation, and the in-process event sink. No network requests are made
+to the telemetry endpoints.
+
+### Pointing telemetry at your own infrastructure
+
+If you operate pythinker for a team and want telemetry routed to your own
+SigNoz / Bugsink instead, override the endpoints via environment variables:
+
+```sh
+export PYTHINKER_SENTRY_DSN="https://<key>@your-bugsink.example.com/<project>"
+export PYTHINKER_OTEL_ENDPOINT="https://your-otel-collector.example.com"
+export PYTHINKER_OTEL_TOKEN="<your bearer token>"
+```
+
+The defaults point at infrastructure operated by the pythinker maintainers; you
+don't need to set anything to use them.
+
+---
+
+## 🛠️ Development
+
+### 🏁 Prepare the workspace
+
+```sh
+git clone https://github.com/mohamed-elkholy95/Pythinker-Code.git
+cd Pythinker-Code
+make prepare
+```
+
+### 🧰 Common commands
+
+<table>
+<tr>
+<td valign="top">
+
+**▶️ Run & iterate**
+```sh
+uv run pythinker          # CLI from source
+make format               # format all packages
+make check                # lint + type-check
+```
+
+</td>
+<td valign="top">
+
+**🧪 Test**
+```sh
+make test                 # all unit + e2e tests
+make ai-test              # AI-driven tests
+make test-pythinker-code   # CLI only
+make test-pythinker-core  # Core only
+make test-pythinker-host  # Host only
+make test-pythinker-sdk   # SDK only
+```
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+**🌐 Frontends**
+```sh
+make web-back             # web backend
+make web-front            # web frontend
+make vis-back             # vis backend
+make vis-front            # vis frontend
+```
+
+</td>
+<td valign="top">
+
+**📦 Build**
+```sh
+make build                # Python packages
+make build-bin            # standalone binary
+make help                 # all targets
+```
+
+</td>
+</tr>
+</table>
+
+> 💡 `make build` and `make build-bin` build and embed the web and visualization frontends before packaging.
+
+---
+
+## 🗂️ Project Layout
+
+```
+pythinker-code/
+├── 📦 src/pythinker_code/         CLI runtime · tools · UIs · ACP · MCP · hooks · plugins · skills · web · vis backends
+├── 🧱 packages/
+│   ├── pythinker-core/           Provider-agnostic message, tool, and chat-provider abstractions
+│   ├── pythinker-host/           Local/remote host filesystem and command execution
+│   └── pythinker-code/           Console-script distribution package
+├── 🧰 sdks/pythinker-sdk/        Python SDK
+└── 🧪 tests/ · tests_e2e/ · tests_ai/   Unit · wire/CLI e2e · AI-driven test suites
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions are warmly welcome — bug reports, PRs, plugins, skills, and docs all help.
+
+- 📖 Start with [`CONTRIBUTING.md`](CONTRIBUTING.md)
+- 🔐 See [`SECURITY.md`](SECURITY.md) for responsible disclosure
+- 📜 Skim [`AGENTS.md`](AGENTS.md) for the agent design notes
+
+If Pythinker helps you, **a ⭐ on GitHub goes a long way.**
+
+---
+
+## 📜 License
+
+Distributed under the **MIT License**. See [`LICENSE`](LICENSE) for the full text and [`NOTICE`](NOTICE) for attributions.
+
+<br />
+
+<div align="center">
+
+**Built with ❤️ for engineers who live in the terminal.**
+
+[🌐 pythinker.com](https://pythinker.com) &nbsp;·&nbsp;
+[📦 PyPI](https://pypi.org/project/pythinker-code/) &nbsp;·&nbsp;
+[🐙 GitHub](https://github.com/mohamed-elkholy95/Pythinker-Code) &nbsp;·&nbsp;
+[🧩 ACP](https://github.com/agentclientprotocol/agent-client-protocol) &nbsp;·&nbsp;
+[🔌 MCP](https://modelcontextprotocol.io/)
+
+</div>