hybard-agent 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,436 @@
1
+ # হাইবার্ড AI Agent — বাংলা গাইড
2
+ ## আমি কি কি করতে পারি
3
+
4
+ ---
5
+
6
+ ## 🚀 দ্রুত রেফারেন্স
7
+
8
+ ### মূল দক্ষতা
9
+ | কাজ | উদাহরণ |
10
+ |------|---------|
11
+ | ✅ কোড লেখা | Python, JS, TS, Dart, SQL |
12
+ | ✅ ফাইল তৈরি | যেকোনো ধরনের ফাইল |
13
+ | ✅ ফাইল সম্পাদনা | বিদ্যমান কোড পরিবর্তন |
14
+ | ✅ ফাইল মুছে ফেলা | অপ্রয়োজনীয় ফাইল সরানো |
15
+ | ✅ কমান্ড চালানো | npm, pip, git ইত্যাদি |
16
+ | ✅ অ্যাপ তৈরি | ওয়েব, মোবাইল, ব্যাকএন্ড |
17
+ | ✅ বাগ ফিক্স করা | ত্রুটি খুঁজে বের করা ও সমাধান |
18
+ | ✅ টেস্ট লেখা | কোড পরীক্ষা করা |
19
+ | ✅ ডিপ্লয় করা | Docker, Cloud |
20
+ | ✅ AI ব্যবহার | LLM, RAG, Agent |
21
+
22
+ ---
23
+
24
+ ## 📁 ফাইল অপারেশন
25
+
26
+ ### ফাইল নিয়ে আমি কি করতে পারি
27
+ ```
28
+ ✅ ফাইল পড়া (Read)
29
+ ✅ নতুন ফাইল তৈরি (Create)
30
+ ✅ ফাইলে লেখা (Write)
31
+ ✅ ফাইল সম্পাদনা (Edit)
32
+ ✅ ফাইল মুছে ফেলা (Delete)
33
+ ✅ নাম দিয়ে খোঁজা (Search by name)
34
+ ✅ কন্টেন্ট দিয়ে খোঁজা (Search by content)
35
+ ✅ ফাইল কপি করা (Copy)
36
+ ✅ ফাইল সরানো (Move)
37
+ ✅ ফাইল রিনেম করা (Rename)
38
+ ```
39
+
40
+ ### ফাইল টাইপ যেগুলো আমি হ্যান্ডেল করি
41
+ ```
42
+ 📝 কোড: .py, .js, .ts, .dart, .sql, .html, .css
43
+ 📄 কনফিগ: .json, .yaml, .yml, .toml, .env
44
+ 📋 ডকস: .md, .txt, .rst
45
+ 🔧 স্ক্রিপ্ট: .sh, .bat, .ps1
46
+ 📦 প্যাকেজ: package.json, requirements.txt, pubspec.yaml
47
+ ```
48
+
49
+ ---
50
+
51
+ ## 💻 প্রোগ্রামিং ভাষা
52
+
53
+ ### ভাষা যেগুলো আমি জানি
54
+ | ভাষা | স্তর | আমি কি করতে পারি |
55
+ |------|-------|-------------------|
56
+ | **Python** | দক্ষ | স্ক্রিপ্ট, API, ML, অটোমেশন |
57
+ | **JavaScript** | দক্ষ | ওয়েব, Node.js, React |
58
+ | **TypeScript** | দক্ষ | টাইপ-সেফ JS, React, API |
59
+ | **Dart** | দক্ষ | Flutter, মোবাইল অ্যাপ |
60
+ | **SQL** | দক্ষ | কোয়েরি, স্কিমা, মাইগ্রেশন |
61
+ | **HTML** | দক্ষ | ওয়েব পেজ, ফর্ম, সিমান্টিক |
62
+ | **CSS** | দক্ষ | স্টাইলিং, Flexbox, Grid |
63
+ | **Bash** | দক্ষ | স্ক্রিপ্ট, অটোমেশন |
64
+
65
+ ### কোড উদাহরণ
66
+ ```python
67
+ # Python
68
+ def hello():
69
+ print("হাইবার্ড থেকে নমস্কার!")
70
+
71
+ # FastAPI
72
+ from fastapi import FastAPI
73
+ app = FastAPI()
74
+
75
+ @app.get("/")
76
+ def read_root():
77
+ return {"Hello": "World"}
78
+ ```
79
+
80
+ ```javascript
81
+ // JavaScript
82
+ const express = require('express');
83
+ const app = express();
84
+
85
+ app.get('/', (req, res) => {
86
+ res.json({ message: 'হাইবার্ড থেকে নমস্কার!' });
87
+ });
88
+
89
+ app.listen(3000);
90
+ ```
91
+
92
+ ```dart
93
+ // Dart/Flutter
94
+ import 'package:flutter/material.dart';
95
+
96
+ void main() {
97
+ runApp(MyApp());
98
+ }
99
+
100
+ class MyApp extends StatelessWidget {
101
+ @override
102
+ Widget build(BuildContext context) {
103
+ return MaterialApp(
104
+ home: Scaffold(
105
+ body: Center(
106
+ child: Text('হাইবার্ড থেকে নমস্কার!'),
107
+ ),
108
+ ),
109
+ );
110
+ }
111
+ }
112
+ ```
113
+
114
+ ---
115
+
116
+ ## 🌐 ওয়েব ডেভেলপমেন্ট
117
+
118
+ ### ফ্রন্টএন্ড যা আমি তৈরি করতে পারি
119
+ | ফ্রেমওয়ার্ক | আমি কি তৈরি করি |
120
+ |--------------|------------------|
121
+ | **React** | কম্পোনেন্ট, হুক, স্টেট ম্যানেজমেন্ট |
122
+ | **Next.js** | SSR অ্যাপ, API রুট, পেজ |
123
+ | **Vue** | কম্পোজিশন API, রিঅ্যাক্টিভ অ্যাপ |
124
+ | **Angular** | এন্টারপ্রাইজ অ্যাপ্লিকেশন |
125
+ | **HTML/CSS** | স্ট্যাটিক সাইট, ল্যান্ডিং পেজ |
126
+
127
+ ### ব্যাকএন্ড যা আমি তৈরি করতে পারি
128
+ | ফ্রেমওয়ার্ক | আমি কি তৈরি করি |
129
+ |--------------|------------------|
130
+ | **FastAPI** | Async Python API |
131
+ | **Flask** | মাইক্রোসার্ভিস |
132
+ | **Django** | ফুল-স্ট্যাক অ্যাপ |
133
+ | **Express** | Node.js API |
134
+ | **NestJS** | TypeScript ব্যাকএন্ড |
135
+
136
+ ### API যা আমি তৈরি করতে পারি
137
+ ```
138
+ ✅ REST API (CRUD অপারেশন)
139
+ ✅ GraphQL API (কোয়েরি, মিউটেশন)
140
+ ✅ WebSocket (রিয়েল-টাইম)
141
+ ✅ SSE (সার্ভার-সেন্ট ইভেন্ট)
142
+ ✅ অথেনটিকেশন (JWT, OAuth)
143
+ ```
144
+
145
+ ---
146
+
147
+ ## 🗄️ ডাটাবেস
148
+
149
+ ### ডাটাবেস যেগুলো আমি ব্যবহার করি
150
+ | ডাটাবেস | টাইপ | আমি কি করতে পারি |
151
+ |----------|------|-------------------|
152
+ | **PostgreSQL** | SQL | জটিল কোয়েরি, স্কিমা |
153
+ | **MySQL** | SQL | ওয়েব অ্যাপ ডাটাবেস |
154
+ | **SQLite** | SQL | এম্বেডেড, টেস্টিং |
155
+ | **MongoDB** | NoSQL | ডকুমেন্ট স্টোরেজ |
156
+ | **Redis** | ক্যাশ | ক্যাশিং, সেশন |
157
+
158
+ ### ডাটাবেস অপারেশন
159
+ ```
160
+ ✅ স্কিমা ডিজাইন করা
161
+ ✅ মাইগ্রেশন লেখা
162
+ ✅ কোয়েরি লেখা
163
+ ✅ পারফরম্যান্স অপ্টিমাইজ করা
164
+ ✅ ইন্ডেক্সিং সেটআপ করা
165
+ ✅ কানেকশন হ্যান্ডেল করা
166
+ ```
167
+
168
+ ---
169
+
170
+ ## 🤖 AI/ML
171
+
172
+ ### AI দক্ষতা
173
+ | এলাকা | আমি কি করতে পারি |
174
+ |--------|-------------------|
175
+ | **LLM** | GPT, Claude, Gemini, Ollama ব্যবহার |
176
+ | **প্রম্পট ইঞ্জিনিয়ারিং** | কার্যকর প্রম্পট ডিজাইন |
177
+ | **RAG** | রিট্রিভাল-অগমেন্টেড জেনারেশন তৈরি |
178
+ | **ভেক্টর DB** | FAISS, Chroma, Qdrant ব্যবহার |
179
+ | **এম্বেডিং** | এম্বেডিং তৈরি ও সার্চ |
180
+ | **Agent** | স্বায়ত্তশাসিত AI Agent তৈরি |
181
+
182
+ ### AI কোড উদাহরণ
183
+ ```python
184
+ # RAG সিস্টেম
185
+ from langchain import ChatOpenAI
186
+ from langchain.vectorstores import Chroma
187
+
188
+ # টুল সহ Agent
189
+ from langchain.agents import initialize_agent
190
+ from langchain.tools import Tool
191
+
192
+ # প্রম্পট টেমপ্লেট
193
+ from langchain.prompts import ChatPromptTemplate
194
+ ```
195
+
196
+ ---
197
+
198
+ ## 🔧 টুল কলিং
199
+
200
+ ### টুল যেগুলো আমি ব্যবহার করি
201
+ | টুল | এটি কি করে |
202
+ |------|------------|
203
+ | `read` | ফাইল পড়ে |
204
+ | `write` | ফাইল তৈরি/লেখে |
205
+ | `edit` | ফাইল সম্পাদনা করে |
206
+ | `bash` | শেল কমান্ড চালায় |
207
+ | `glob` | প্যাটার্ন দিয়ে ফাইল খুঁজে |
208
+ | `grep` | ফাইল কন্টেন্ট সার্চ করে |
209
+ | `webfetch` | ওয়েব পেজ ফেচ করে |
210
+ | `websearch` | ইন্টারনেটে সার্চ করে |
211
+
212
+ ### টুল চেইন উদাহরণ
213
+ ```
214
+ প্রজেক্ট তৈরি:
215
+ mkdir → npm init → write package.json → write files → npm install
216
+
217
+ বাগ ফিক্স:
218
+ read error → grep related code → edit fix → run tests
219
+
220
+ ফিচার তৈরি:
221
+ read codebase → plan → write files → edit existing → test → build
222
+ ```
223
+
224
+ ---
225
+
226
+ ## 🐛 ডিবাগিং
227
+
228
+ ### আমি কি ডিবাগ করতে পারি
229
+ ```
230
+ ✅ সিনট্যাক্স এরর
231
+ ✅ রানটাইম এরর
232
+ ✅ লজিক এরর
233
+ ✅ টাইপ এরর
234
+ ✅ নেটওয়ার্ক এরর
235
+ ✅ ডাটাবেস এরর
236
+ ✅ API এরর
237
+ ✅ পারফরম্যান্স সমস্যা
238
+ ```
239
+
240
+ ### ডিবাগিং ফ্লো
241
+ ```
242
+ 1. এরর মেসেজ পড়ুন
243
+ 2. এরর লোকেশন খুঁজুন
244
+ 3. মূল কারণ বিশ্লেষণ করুন
245
+ 4. সমাধান তৈরি করুন
246
+ 5. সমাধান প্রয়োগ করুন
247
+ 6. সমাধান পরীক্ষা করুন
248
+ 7. সফলতা যাচাই করুন
249
+ ```
250
+
251
+ ---
252
+
253
+ ## 🧪 টেস্টিং
254
+
255
+ ### টেস্ট যেগুলো আমি লিখতে পারি
256
+ | টাইপ | কি পরীক্ষা করে |
257
+ |------|----------------|
258
+ | **ইউনিট** | একক ফাংশন |
259
+ | **ইন্টিগ্রেশন** | কম্পোনেন্ট ইন্টারঅ্যাকশন |
260
+ | **E2E** | সম্পূর্ণ ওয়ার্কফ্লো |
261
+ | **API** | এন্ডপয়েন্ট আচরণ |
262
+
263
+ ### টেস্টিং টুল
264
+ ```
265
+ ✅ Jest (JavaScript)
266
+ ✅ Pytest (Python)
267
+ ✅ Vitest (Vite)
268
+ ✅ Flutter Test (Dart)
269
+ ✅ Mocha (Node.js)
270
+ ```
271
+
272
+ ---
273
+
274
+ ## 🚀 ডিপ্লয়মেন্ট
275
+
276
+ ### যা আমি ডিপ্লয় করতে পারি
277
+ ```
278
+ ✅ ওয়েব অ্যাপ ক্লাউডে
279
+ ✅ API সার্ভারে
280
+ ✅ Docker কন্টেইনার
281
+ ✅ স্ট্যাটিক সাইট
282
+ ✅ মোবাইল অ্যাপ (Flutter)
283
+ ```
284
+
285
+ ### ডিপ্লয়মেন্ট টার্গেট
286
+ ```
287
+ ☁️ ক্লাউড: AWS, GCP, Azure
288
+ 🐳 কন্টেইনার: Docker, Kubernetes
289
+ 🌐 CDN: Netlify, Vercel, Cloudflare
290
+ 🗄️ ডাটাবেস: Supabase, Firebase, PlanetScale
291
+ ```
292
+
293
+ ---
294
+
295
+ ## 🔒 সিকিউরিটি
296
+
297
+ ### সিকিউরিটি প্র্যাকটিস যেগুলো আমি মেনে চলি
298
+ ```
299
+ ✅ কখনো সিক্রেট হার্ডকোড করি না
300
+ ✅ এনভায়রনমেন্ট ভ্যারিয়েবল ব্যবহার করি
301
+ ✅ ব্যবহারকারীর ইনপুট যাচাই করি
302
+ ✅ আউটপুট স্যানিটাইজ করি
303
+ ✅ প্যারামিটারাইজড কোয়েরি ব্যবহার করি
304
+ ✅ OWASP গাইডলাইন অনুসরণ করি
305
+ ✅ এরর নিরাপদে হ্যান্ডেল করি
306
+ ✅ HTTPS ব্যবহার করি
307
+ ```
308
+
309
+ ---
310
+
311
+ ## 📱 মোবাইল ডেভেলপমেন্ট
312
+
313
+ ### Flutter অ্যাপ যেগুলো আমি তৈরি করতে পারি
314
+ ```
315
+ ✅ UI কম্পোনেন্ট
316
+ ✅ স্টেট ম্যানেজমেন্ট (Riverpod, Provider)
317
+ ✅ নেভিগেশন
318
+ ✅ API ইন্টিগ্রেশন
319
+ ✅ লোকাল স্টোরেজ
320
+ ✅ পুশ নোটিফিকেশন
321
+ ✅ ক্যামেরা/লোকেশন
322
+ ✅ অ্যানিমেশন
323
+ ```
324
+
325
+ ---
326
+
327
+ ## 🌍 মাল্টিলিঙ্গুয়াল
328
+
329
+ ### ভাষা সাপোর্ট
330
+ | ভাষা | কোড | সাপোর্ট |
331
+ |------|------|---------|
332
+ | বাংলা | bn | নেটিভ |
333
+ | English | en | নেটিভ |
334
+ | हिन्दी | hi | সাপোর্টেড |
335
+ | 中文 | zh | সাপোর্টেড |
336
+ | 日本語 | ja | সাপোর্টেড |
337
+ | العربية | ar | সাপোর্টেড |
338
+ | Español | es | সাপোর্টেড |
339
+ | Français | fr | সাপোর্টেড |
340
+
341
+ ---
342
+
343
+ ## ⚡ পারফরম্যান্স
344
+
345
+ ### যা আমি অপ্টিমাইজ করি
346
+ ```
347
+ ✅ কোড এফিশিয়েন্সি
348
+ ✅ ডাটাবেস কোয়েরি
349
+ ✅ API রেসপন্স টাইম
350
+ ✅ বান্ডেল সাইজ
351
+ ✅ মেমরি ব্যবহার
352
+ ✅ লোড টাইম
353
+ ```
354
+
355
+ ---
356
+
357
+ ## 📊 প্রজেক্ট টাইপ
358
+
359
+ ### সম্পূর্ণ প্রজেক্ট যেগুলো আমি তৈরি করতে পারি
360
+ | টাইপ | কম্পোনেন্ট |
361
+ |------|------------|
362
+ | **ওয়েব অ্যাপ** | ফ্রন্টএন্ড + ব্যাকএন্ড + ডাটাবেস |
363
+ | **মোবাইল অ্যাপ** | Flutter + API + ডাটাবেস |
364
+ | **API সার্ভিস** | REST/GraphQL + Auth + DB |
365
+ | **CLI টুল** | Node.js/Python + কমান্ড |
366
+ | **AI Agent** | LLM + টুল + মেমরি |
367
+ | **ফুল স্ট্যাক** | উপরের সব একসাথে |
368
+
369
+ ---
370
+
371
+ ## �য় টাস্ক উদাহরণ
372
+
373
+ ### "একটা লগইন পেজ তৈরি করো"
374
+ ```
375
+ 1. HTML ফর্ম লেখো
376
+ 2. CSS স্টাইলিং যোগ করো
377
+ 3. JavaScript ভ্যালিডেশন যোগ করো
378
+ 4. ব্যাকএন্ড API তৈরি করো
379
+ 5. ডাটাবেস স্টোরেজ যোগ করো
380
+ 6. JWT অথ বাস্তবায়ন করো
381
+ 7. সবকিছু পরীক্ষা করো
382
+ ```
383
+
384
+ ### "এই বাগটা ফিক্স করো"
385
+ ```
386
+ 1. এররটা পড়ো
387
+ 2. কোডটা খুঁজো
388
+ 3. সমস্যাটা বুঝো
389
+ 4. সমাধান লেখো
390
+ 5. সমাধান পরীক্ষা করো
391
+ 6. কাজ করছে কিনা যাচাই করো
392
+ ```
393
+
394
+ ### "একটা REST API তৈরি করো"
395
+ ```
396
+ 1. প্রজেক্ট স্ট্রাকচার সেটআপ করো
397
+ 2. রুট তৈরি করো
398
+ 3. মিডলওয়্যার যোগ করো
399
+ 4. ডাটাবেস কানেক্ট করো
400
+ 5. অথেনটিকেশন যোগ করো
401
+ 6. টেস্ট লেখো
402
+ 7. ডিপ্লয় করো
403
+ ```
404
+
405
+ ---
406
+
407
+ ## 🆘 সাহায্য প্রয়োজন হলে
408
+
409
+ ### আমি জিজ্ঞাসা করব:
410
+ ```
411
+ ❓ প্রয়োজনীয়তা সম্পর্কে স্পষ্টীকরণ
412
+ ❓ নির্দিষ্ট ফ্রেমওয়ার্ক পছন্দ
413
+ ❓ ডাটাবেস পছন্দ
414
+ ❓ ডিপ্লয়মেন্ট টার্গেট
415
+ ❓ API ক্রেডেনশিয়াল
416
+ ❓ টেস্টিং পছন্দ
417
+ ```
418
+
419
+ ---
420
+
421
+ ## 📈 গ্রোথ এলাকা
422
+
423
+ ### যেগুলো আমি শিখছি
424
+ ```
425
+ 🔄 অ্যাডভান্সড ML মডেল ট্রেনিং
426
+ 🔄 জটিল মাইক্রোসার্ভিস
427
+ 🔄 রিয়েল-টাইম সিস্টেম
428
+ 🔄 অ্যাডভান্সড মোবাইল ফিচার
429
+ 🔄 এজ কম্পিউটিং
430
+ ```
431
+
432
+ ---
433
+
434
+ *এই গাইড হাইবার্ড AI Agent-এর ক্ষমতার দ্রুত রেফারেন্স।*
435
+ *বিস্তারিত তথ্যের জন্য KNOWLEDGE_BASE.md দেখুন।*
436
+ *শেষ আপডেট: 2026-07-26*