https://github.com/zacxyonly/simplecontext-plugin
Official & community plugin registry for SimpleContext. Drop-in plugins to extend your AI agent's memory, retrieval, and behavior. First plugin: vector search (semantic similarity) — zero dependency.
https://github.com/zacxyonly/simplecontext-plugin
ai-agent embedding llm memory plugin plugin-registry python semantic-search simplecontext vector-search
Last synced: about 1 month ago
JSON representation
Official & community plugin registry for SimpleContext. Drop-in plugins to extend your AI agent's memory, retrieval, and behavior. First plugin: vector search (semantic similarity) — zero dependency.
- Host: GitHub
- URL: https://github.com/zacxyonly/simplecontext-plugin
- Owner: zacxyonly
- License: mit
- Created: 2026-03-16T17:32:23.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-17T07:52:07.000Z (3 months ago)
- Last Synced: 2026-03-17T22:51:49.639Z (3 months ago)
- Topics: ai-agent, embedding, llm, memory, plugin, plugin-registry, python, semantic-search, simplecontext, vector-search
- Language: Python
- Homepage: https://github.com/zacxyonly/SimpleContext
- Size: 47.9 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
🧩 SimpleContext-Plugin
Official & Community Plugin Registry for SimpleContext
[](LICENSE)
[](CONTRIBUTING.md)
[](https://github.com/zacxyonly/SimpleContext)
> Plugin repository resmi untuk ekosistem [SimpleContext](https://github.com/zacxyonly/SimpleContext).
> Temukan, pasang, dan kontribusi plugin untuk memperluas kemampuan SimpleContext.
[Cara Pasang](#-cara-pasang) · [Plugin Tersedia](#-plugin-tersedia) · [Buat Plugin](#-buat-plugin-baru) · [Kontribusi](#-kontribusi)
---
## 📦 Plugin Tersedia
### Official Plugins
| Plugin | Deskripsi | Versi | Commands |
|--------|-----------|-------|----------|
| 📊 [`plugin-analytics`](./official/plugin-analytics/) | Usage analytics — statistik pesan, agent, dan aktivitas per user. | `1.0.0` | `/analytics`, `/analytics_global` |
| ⏱ [`plugin-rate-limiter`](./official/plugin-rate-limiter/) | Batasi request per user per jam/hari, estimasi token dan biaya. | `1.0.0` | `/usage` |
| 😊 [`plugin-sentiment`](./official/plugin-sentiment/) | Analisis sentimen user — adaptasi tone agent saat user frustrasi. | `1.0.0` | `/sentiment` |
| 📝 [`plugin-summarizer`](./official/plugin-summarizer/) | Ringkasan otomatis percakapan ke episodic memory via LLM. | `1.0.0` | `/summary`, `/summary_list` |
| 🌏 [`plugin-translate`](./official/plugin-translate/) | Penerjemah multi-bahasa — auto-detect bahasa user dan terjemahkan response. | `1.0.0` | `/translate` |
| 🔍 [`plugin-vector-search`](./official/plugin-vector-search/) | Semantic vector search berbasis embedding — komplemen keyword retrieval. | `1.0.0` | `/semantic` |
| 🌐 [`plugin-web-search`](./official/plugin-web-search/) | Pencarian internet real-time — DuckDuckGo (free), Bing, atau Google. | `1.0.0` | `/search` |
### Community Plugins
| Plugin | Author | Deskripsi | Status |
|--------|--------|-----------|--------|
| *(kirim plugin kamu!)* | — | — | — |
---
## 🚀 Cara Pasang
### Manual (recommended)
Salin file plugin ke folder `plugins/` di project SimpleContext kamu:
```bash
# Clone repo ini
git clone https://github.com/zacxyonly/SimpleContext-Plugin
cd SimpleContext-Plugin
# Salin plugin yang diinginkan
cp official/plugin-vector-search/vector_search_plugin.py /path/to/your-project/plugins/
```
Aktifkan di `config.yaml`:
```yaml
plugins:
enabled: true
folder: ./plugins
vector_search_plugin:
enabled: true
provider: local # local | openai | ollama
top_k: 5
min_score: 0.15
tiers: [semantic, episodic]
```
### Lewat `sc.use()` (tanpa file)
```python
from plugins.vector_search_plugin import VectorSearchPlugin
sc = SimpleContext("config.yaml")
sc.use(VectorSearchPlugin(config={
"provider": "local",
"top_k": 5,
}))
```
---
## 🏗️ Struktur Repositori
```
SimpleContext-Plugin/
├── README.md ← Kamu di sini
├── CONTRIBUTING.md ← Panduan kontribusi
├── LICENSE
├── official/ ← Plugin resmi (core team)
│ └── plugin-vector-search/
│ ├── vector_search_plugin.py ← File plugin (taruh di ./plugins/)
│ └── README.md
├── community/ ← Kontribusi komunitas
│ └── README.md
└── templates/
└── plugin-starter/ ← Template untuk plugin baru
├── my_plugin.py
└── README.md
```
---
## 🛠️ Buat Plugin Baru
1. Copy template:
```bash
cp -r templates/plugin-starter community/plugin-namakalian
```
2. Edit `my_plugin.py` — rename class dan implementasi hook
3. Test lokal dengan SimpleContext
4. Submit Pull Request
Lihat [CONTRIBUTING.md](CONTRIBUTING.md) untuk detail lengkap.
---
## 🔗 Ekosistem
| Repositori | Deskripsi |
|------------|-----------|
| [SimpleContext](https://github.com/zacxyonly/SimpleContext) | Core engine — Universal AI Brain, zero dependencies |
| [SimpleContext-Plugin](https://github.com/zacxyonly/SimpleContext-Plugin) | Plugin registry *(kamu di sini)* |
| [SimpleContext-Bot](https://github.com/zacxyonly/SimpleContext-Bot) | AI Telegram Bot powered by SimpleContext — one-command setup, auto-downloads engine + agents |
| [SimpleContext-Agents](https://github.com/zacxyonly/SimpleContext-Agents) | Ready-to-use agent definitions for SimpleContext |
---
## 📄 License
MIT © [zacxyonly](https://github.com/zacxyonly)