> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent সোশ্যাল মিডিয়া ইন্টিগ্রেশন

> Nous Research Hermes Agent-কে Social media studio-র সাথে সংযুক্ত করে পোস্ট শিডিউল করুন, মেসেজের উত্তর দিন এবং আপনার সোশ্যাল অ্যাকাউন্ট জুড়ে অ্যানালিটিক্স পড়ুন।

Social media studio [অফিশিয়াল Nous Research Hermes Agent](https://hermes-agent.nousresearch.com/) (এবং যেকোনো Hermes 4 মডেল)-এর সাথে তিনটি প্রকাশিত ডিস্ট্রিবিউশন চ্যানেলের মাধ্যমে ইন্টিগ্রেট হয় — আপনার ব্যবহারকারীরা যেভাবে ইনস্টল করতে চান সেটি বেছে নিন। তিনটিই একই API কী দিয়ে একই ব্যাকএন্ডের সাথে কথা বলে। স্কিল পথ এটিকে `SOME_API_KEY` হিসেবে এক্সপোর্ট করে (`so-me` CLI এই ভেরিয়েবলটি পড়ে); MCP কনফিগ ও npm রানটাইম `SOMESTUDIO_API_KEY` পড়ে।

| পথ | ইনস্টল | কার জন্য সেরা |
| - | - | - |
| **স্কিল (প্রস্তাবিত)** | `hermes skills install 7t1-studio/so-me-hermes-skill/so-me-studio` | যাঁরা তৈরি-করা ইন্টিগ্রেশনের জন্য [skills.sh](https://skills.sh) ঘুরে দেখেন — SAFE রায়সহ অটো-সিকিউরিটি স্ক্যান পাস করে |
| **MCP** | `~/.hermes/config.yaml`-এ 5 লাইনের একটি `mcp_servers:` ব্লক পেস্ট করুন | যেসব Hermes Agent ব্যবহারকারী MCP-over-HTTP পছন্দ করেন এবং CLI বাইনারি চান না |
| **স্ট্যান্ডঅ্যালোন npm রানটাইম** | `npm install -g @so-me/hermes-agent` | স্ক্রিপ্ট, cron জব, CI ইন্টিগ্রেশন, হেডলেস সার্ভার |

**স্কিল (Hermes Hub)**

**1. Hermes Agent ইনস্টল করুন**

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc   # or ~/.zshrc
hermes --version
```

**2. একটি LLM ব্যাকএন্ড বেছে নিন**

```bash theme={null}
hermes model
```

প্রস্তাবিত: `nousresearch/hermes-4-405b` (সেরা মান) বা `nousresearch/hermes-4-70b` (সস্তা, প্রায় 10× দ্রুত) সহ **OpenRouter**। প্রম্পট এলে আপনার OpenRouter API কী পেস্ট করুন।

**3. Social media studio CLI ইনস্টল করুন**

স্কিলটি প্রকাশিত [`@social-media-scheduler/cli`](https://www.npmjs.com/package/@social-media-scheduler/cli) বাইনারি চালায়, তাই CLI অবশ্যই PATH-এ থাকতে হবে:

```bash theme={null}
npm install -g @social-media-scheduler/cli
so-me --version
```

**4. Social media studio স্কিল ইনস্টল করুন**

```bash theme={null}
hermes skills install 7t1-studio/so-me-hermes-skill/so-me-studio
```

Hermes স্কিলটিতে একটি স্বয়ংক্রিয় সিকিউরিটি স্ক্যান চালায় (ডেটা-এক্সফিল্ট্রেশন, প্রম্পট-ইনজেকশন, ধ্বংসাত্মক-কমান্ড চেক) এবং নিশ্চিতকরণ চায়। বর্তমান রায় **SAFE**।

ইনস্টলের সময় Hermes `SOME_API_KEY` চায় — [so-me.studio/settings?tab=api](https://so-me.studio/settings?tab=api) থেকে একটি তৈরি করে পেস্ট করুন।

**5. এজেন্ট চালু করুন**

```bash theme={null}
hermes --tui
```

TUI-এর ভেতরে স্কিল রেজিস্টার হয়েছে কি না নিশ্চিত করতে `/tools` টাইপ করুন। so-me-studio স্কিলের আওতাভুক্ত এন্ট্রি দেখা যাওয়ার কথা।

বিস্তারিত পেজ: [skills.sh/7t1-studio/so-me-hermes-skill/so-me-studio](https://skills.sh/7t1-studio/so-me-hermes-skill/so-me-studio)

**MCP সার্ভার কনফিগ**

**1. Hermes Agent + LLM ইনস্টল করুন**

স্কিল পথের প্রথম দুটি ধাপই এখানেও:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes model    # pick OpenRouter + nousresearch/hermes-4-405b
```

**2. আপনার Social media studio API কী Hermes সিক্রেট হিসেবে সংরক্ষণ করুন**

```bash theme={null}
hermes config set SOMESTUDIO_API_KEY sk_live_...
```

কী-টি [so-me.studio/settings?tab=api](https://so-me.studio/settings?tab=api) থেকে তৈরি করুন।

**3. \~/.hermes/config.yaml-এ MCP ব্লক যোগ করুন**

```yaml theme={null}
mcp_servers:
  so-me-studio:
    url: https://api.so-me.studio/mcp
    headers:
      X-API-Key: ${SOMESTUDIO_API_KEY}
```

HTTP ট্রান্সপোর্ট `url:` থেকে অনুমান করা হয়; কোনো `transport:` কী লাগে না। হুবহু স্নিপেটটি আছে [`apps/agent-kits/hermes/configs/hermes-agent.yaml`](https://github.com/7t1-studio/schedular-app/blob/main/apps/agent-kits/hermes/configs/hermes-agent.yaml)-এ।

**4. চালু করে যাচাই করুন**

```bash theme={null}
hermes --tui
```

TUI-এর ভেতরে `/tools` টাইপ করুন — Social media studio-র সব 205টি টুল `mcp_so-me-studio_<tool_name>` নামে রেজিস্টার হয় (যেমন `mcp_so-me-studio_create_post`)।

> [!TIP]
>
> লোকাল ব্যাকএন্ডে পয়েন্ট করছেন? স্নিপেটে URL বদলে দিন — `url: http://localhost:8000/mcp`।

**স্ট্যান্ডঅ্যালোন npm রানটাইম**

**1. রানটাইম ইনস্টল করুন**

```bash theme={null}
npm install -g @so-me/hermes-agent
# or run ad-hoc without installing:
npx @so-me/hermes-agent "your prompt"
```

npm: [@so-me/hermes-agent](https://www.npmjs.com/package/@so-me/hermes-agent)

**2. এনভায়রনমেন্ট ভেরিয়েবল সেট করুন**

```bash theme={null}
# Social media studio
export SOMESTUDIO_API_KEY=sk_live_...

# Inference backend (OpenRouter, Together, vLLM, or Ollama)
export HERMES_BASE_URL=https://openrouter.ai/api/v1
export HERMES_API_KEY=sk-or-...
export HERMES_MODEL=nousresearch/hermes-4-405b
```

**3. চালান**

```bash theme={null}
so-me-hermes "List my connected social accounts"
so-me-hermes "Schedule a tweet 'launching today' for 9am UTC tomorrow"
so-me-hermes "Generate a Friday LinkedIn caption about Q2 wins"
```

রানটাইম এজেন্টিক লুপ চালায়, যুক্তি + টুল কল + চূড়ান্ত উত্তর প্রিন্ট করে এবং বেরিয়ে যায়। দীর্ঘ সেশন দরকার হলে `MAX_TURNS=16` দিয়ে টার্ন সীমা বেঁধে দিন।

> [!NOTE]
>
> স্ট্যান্ডঅ্যালোন রানটাইম **যেকোনো OpenAI-সামঞ্জস্যপূর্ণ ইনফারেন্স এন্ডপয়েন্টের** সাথে কাজ করে — `HERMES_BASE_URL`, `HERMES_API_KEY` ও `HERMES_MODEL` GPT-4o, Claude (Anthropic API-র মাধ্যমে), Mistral, DeepSeek বা লোকাল Ollama / vLLM-এ পয়েন্ট করুন। রেডি-টু-ইউজ এনভ টেমপ্লেট আছে [`configs/`](https://github.com/7t1-studio/schedular-app/tree/main/apps/agent-kits/hermes/configs)-এ।

### লাইব্রেরি API

রানটাইমটি বড় কোনো Node অ্যাপে এমবেড করুন:

```ts theme={null}
import { runAgent } from '@so-me/hermes-agent';

const result = await runAgent({
  prompt: "Schedule a tweet 'hello' for tomorrow at 9am UTC",
  soMeApiKey: process.env.SOMESTUDIO_API_KEY!,
  hermesBaseUrl: 'https://openrouter.ai/api/v1',
  hermesApiKey: process.env.HERMES_API_KEY!,
  hermesModel: 'nousresearch/hermes-4-405b',
  onMessage: (msg) => console.log(msg.role, msg.content),
});
```

এজেন্টকে ছোট পরিসরে সীমিত করতে বা পার্সোনা বদলাতে বান্ডেল করা `tools` ও `systemPrompt` ওভাররাইড করুন।

## আপনি যা জিজ্ঞেস করতে পারেন

একই প্রম্পট তিনটি পথেই কাজ করে:

| প্রম্পট | কী হয় |
| - | - |
| *"আমার যুক্ত সোশ্যাল অ্যাকাউন্টগুলোর তালিকা দাও।"* | `list_accounts` কল করে, প্ল্যাটফর্ম অনুযায়ী সারসংক্ষেপ দেয় |
| *"আগামীকাল সকাল 9টা UTC-তে 'hello world' লিখে একটি টুইট শিডিউল করো।"* | ISO টাইমস্ট্যাম্প হিসাব করে, `create_post` কল করে |
| *"Q2-র সাফল্য নিয়ে শুক্রবারের একটি LinkedIn ক্যাপশন তৈরি করে বিকেল 5টায় শিডিউল করো।"* | শুরু থেকে শেষ পর্যন্ত `generate_and_schedule` কল করে |
| *"ওই DM-এর উত্তরে আমার সংরক্ষিত 'pricing' টেমপ্লেটটি পাঠাও।"* | সংরক্ষিত উত্তরটি খুঁজে নেয়, `reply_to_conversation` কল করে |
| *"গত সপ্তাহে আমার Twitter পোস্টগুলোর পারফরম্যান্স কেমন ছিল?"* | `--days 7` সহ `get_platform_analytics` কল করে |
| *"অপেক্ষমাণ সব পোস্ট অনুমোদন করো।"* | `list_approvals` কল করে, তারপর প্রতিটির জন্য `approve_post` |

এজেন্ট **Social media studio-র সব 205টি টুল** ব্যবহার করতে পারে — ড্যাশবোর্ডে যে প্রতিটি কাজ সম্ভব, এখানেও তা সম্ভব। গ্রুপ করা পূর্ণ ক্যাটালগ: [`bundle/tools.md`](https://github.com/7t1-studio/schedular-app/blob/main/apps/agent-kits/hermes/bundle/tools.md)।

## এটি কীভাবে কাজ করে

```
            ┌──────────────────────┐
            │ user prompt          │
            └──────────┬───────────┘
                       │
   ┌───────────────────┼───────────────────┐
   ▼                   ▼                   ▼
┌──────────┐   ┌──────────────┐   ┌──────────────────┐
│ Skill    │   │ MCP config   │   │ Standalone npm   │
│ install  │   │ in           │   │ runtime          │
│ via      │   │ ~/.hermes/   │   │ (so-me-hermes)   │
│ skills.sh│   │ config.yaml  │   │                  │
└─────┬────┘   └──────┬───────┘   └────────┬─────────┘
      │               │                    │
      │ shells out    │ POST /mcp          │ POST /mcp
      ▼               ▼                    ▼
┌──────────────┐  ┌──────────────────────────────────┐
│ CLI (so-me)  │  │ api.so-me.studio                 │
└──────┬───────┘  └──────────────────────────────────┘
       │ HTTP REST
       ▼
   Social media studio backend
```

তিনটি পথই একই ব্যাকএন্ড, একই API কী (CLI স্কিলের জন্য `SOME_API_KEY`, MCP ও npm রানটাইমের জন্য `SOMESTUDIO_API_KEY`) এবং একই হাতে-লেখা নির্দেশনায় ([`bundle/SKILL.md`](https://github.com/7t1-studio/schedular-app/blob/main/apps/agent-kits/hermes/bundle/SKILL.md)) মিলিত হয়। স্কিল ও CLI শেল-আউট পথ ভেতরে HTTP REST ব্যবহার করে; MCP ও npm রানটাইম পথ `/mcp`-র উপর JSON-RPC ব্যবহার করে।

## সিস্টেম প্রম্পটে বাঁধা কঠোর নিয়ম

* টুল কলের আগে `<think>...</think>`-এর ভেতরে যুক্তি দেওয়া
* কখনো ID (অ্যাকাউন্ট, পোস্ট, কথোপকথন) বানিয়ে না বলা — সবসময় আগে খুঁজে নেওয়া
* `scheduledAt` অবশ্যই ISO 8601 UTC এবং কঠোরভাবে ভবিষ্যতের হতে হবে
* একাধিক ধাপের কাজ (ছবি → আপলোড → পোস্ট) ক্রমানুসারে চলে
* অনুরোধ করলেও কখনো API কী বা ওয়েবহুক সিক্রেট প্রকাশ না করা

পূর্ণ কঠোর-নিয়মের তালিকা ও সিদ্ধান্ত-গাছ: [`bundle/SKILL.md`](https://github.com/7t1-studio/schedular-app/blob/main/apps/agent-kits/hermes/bundle/SKILL.md)।

## সোর্স

ইন্টিগ্রেশন কিটগুলো Social media studio মনোরেপোতে আছে:

| পাথ | কী |
| - | - |
| [`apps/agent-kits/hermes/`](https://github.com/7t1-studio/schedular-app/tree/main/apps/agent-kits/hermes) | npm রানটাইম + MCP কনফিগ স্নিপেট |
| [`apps/agent-kits/hermes-skill/`](https://github.com/7t1-studio/schedular-app/tree/main/apps/agent-kits/hermes-skill) | CLI-শেল-আউট স্কিল বান্ডেল (skills.sh tap রেপোতে মিরর করা) |
| [`7t1-studio/so-me-hermes-skill`](https://github.com/7t1-studio/so-me-hermes-skill) | Hermes Hub রেজিস্ট্রি tap (`hermes skills install`-এর সোর্স) |
| [`@so-me/hermes-agent`](https://www.npmjs.com/package/@so-me/hermes-agent) | npm প্যাকেজ (`npm install -g @so-me/hermes-agent`-এর সোর্স) |

PR স্বাগত — regen ও রিলিজ ওয়ার্কফ্লোর জন্য কিট-স্তরের `PUBLISHING.md` ফাইলগুলো দেখুন।

## আপডেট

Social media studio ব্যাকএন্ডে নতুন টুল এলে:

* **স্কিল / MCP / npm রানটাইম** — `so-me agent export-tools --format hermes` দিয়ে লাইভ MCP ক্যাটালগ থেকে `bundle/tools.json` ও `bundle/tools.md` পুনরায় তৈরি হয়। npm প্যাকেজ আবার npm-এ প্রকাশিত হয়; স্কিল বান্ডেল তার tap রেপোতে আবার প্রকাশিত হয়।
* **স্কিল পথের শেষ ব্যবহারকারীরা** সর্বশেষটি পেতে `hermes skills update so-me-studio` চালান।
* **npm পথের শেষ ব্যবহারকারীরা** সর্বশেষটি পেতে `npm install -g @so-me/hermes-agent@latest` চালান।
* **MCP পথের শেষ ব্যবহারকারীরা** পরের স্টার্টআপে নিজে থেকেই নতুন টুল পেয়ে যান (ক্লায়েন্ট-পক্ষে আপডেট লাগে না — Hermes Agent প্রতিটি সেশনে `/mcp` থেকে টুলের তালিকা আবার আনে)।

## অন্য এজেন্ট?

আপনি ভিন্ন এজেন্ট রানটাইম ব্যবহার করলে:

* **Claude Desktop / Cursor / OpenCode** — [OpenClaw ইন্টিগ্রেশন](/bn/integrations/openclaw.md) ইনস্টল করুন (`npm install -g @social-media-scheduler/cli`, তারপর [22টি মেসেঞ্জারের](/bn/integrations/openclaw.md#যেকোনো-মেসেঞ্জার-থেকে-চ্যাট-করুন) যেকোনোটি দিয়ে চ্যাট করুন)
* **নেটিভ MCP ক্লায়েন্ট** (Claude Desktop ম্যানিফেস্ট, Cursor ইত্যাদি) — একই `mcp_servers:` স্নিপেট ধাঁচে সরাসরি [MCP সার্ভারে](/bn/mcp/overview.md) পয়েন্ট করুন
* **LangGraph, CrewAI, OpenAI Assistants, Anthropic API** — তাদের পছন্দের ফরম্যাটে একটি টুল ডেফিনিশন ফাইল তৈরি করুন:

  ```bash theme={null}
  so-me agent export-tools --format openai --out tools.openai.json
  so-me agent export-tools --format anthropic --out tools.anthropic.json
  so-me agent export-tools --format mcp --out tools.mcp.json
  ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.