অরেলিও টিউটোরিয়াল: স্থানীয়ভাবে একটি ব্যক্তিগত AI-চালিত সম্পদ ব্যবস্থাপনা অ্যাপ চালান

Aurelio কী?

Aurelio হলো স্ব-হোস্ট করা সম্পদ-ব্যবস্থাপনা ও আর্থিক পরিকল্পনার একটি অ্যাপ্লিকেশন। এটি আপনার নিজের কম্পিউটারে চলে, আপনার আর্থিক রেকর্ড স্থানীয়ভাবে সংরক্ষণ করে এবং পোর্টফোলিও, নগদ প্রবাহ, লক্ষ্য, পরিকল্পনা, বাড়ি ও ঋণের জন্য ড্যাশবোর্ড সরবরাহ করে।

ঐচ্ছিক AI উপদেষ্টাকে ব্যবহার করে আপনি আপনার রেকর্ড সম্পর্কে প্রশ্ন করতে, ওয়েবে অনুসন্ধান করতে এবং কার্ড আকারে প্রস্তাবিত পরিবর্তন পেতে পারেন, যেগুলো আপনি অনুমোদন বা প্রত্যাখ্যান করতে পারবেন। AI অনুরোধে আপনার নিজস্ব OpenRouter অ্যাকাউন্ট ও API key ব্যবহার হয়।

Aurelio আপনার কম্পিউটারে ব্যক্তিগত ব্যবহারের জন্য তৈরি। আপনার রেকর্ড স্থানীয়ভাবে backend/data.db-এ সংরক্ষিত থাকে।

প্রধান বৈশিষ্ট্য

• সম্পদ ট্র্যাকিং: ব্যাংক, ব্রোকার, নগদ অর্থ এবং সময়-নির্দিষ্ট পরিস্থিতি পরিচালনা করুন, যেখানে আপনার মালিকানাধীন সম্পদ বর্ণনা করা যায়।
• পোর্টফোলিও বিশ্লেষণ: বাজারদর অনুযায়ী মূল্যায়িত পজিশন দেখুন, যার মধ্যে খরচ, লাভ এবং লভ্যাংশ অন্তর্ভুক্ত।
• ফান্ডের অন্তর্নিহিত বিশ্লেষণ: দেশ, খাত, কোম্পানি ও মুদ্রা অনুযায়ী ফান্ডের হোল্ডিং পরীক্ষা করুন।
• পরিকল্পনা, বাড়ি ও ঋণ: নিয়মিত বিনিয়োগ, বাস্তব সম্পদ এবং সেগুলোর অর্থায়নে ব্যবহৃত ঋণ ট্র্যাক করুন।
• নগদ প্রবাহ ও লক্ষ্য: আয়, ব্যয়, সঞ্চয়ের হার এবং প্রতিটি লক্ষ্যের জন্য প্রয়োজনীয় রিটার্ন পর্যালোচনা করুন।
• Aurelio-কে জিজ্ঞাসা করুন: এমন একটি AI উপদেষ্টার সঙ্গে চ্যাট করুন, যে আপনার রেকর্ড ব্যবহার করে, ওয়েবে অনুসন্ধান করতে পারে এবং আপনার অনুমোদনের জন্য পরিবর্তনের প্রস্তাব দেয়।
• বিশ্লেষণ: একজন বিশ্লেষক ও একজন বিশ্বস্ত পরামর্শদাতার দৃষ্টিভঙ্গি তুলনা করুন, এরপর প্রথমে কী পরীক্ষা করা উচিত তার একটি সংশ্লেষ পান।

অ্যাপ্লিকেশনটির পেছনের ধারণাগুলো জানতে পড়ুন Aurelio কীভাবে যুক্তি দেয়।

পূর্বশর্ত

Aurelio ইনস্টল করার আগে নিশ্চিত করুন যে আপনার কাছে নিম্নলিখিত টুলগুলো আছে:

• Git
• Node.js 22 বা পরবর্তী সংস্করণ
• uv

প্রথমবার চালুর সময় অন্তর্ভুক্ত স্টার্টআপ স্ক্রিপ্টটি প্রকল্প ফোল্ডারের ভেতরে প্রয়োজনীয় নির্ভরতাগুলো ইনস্টল করে।

ডেমো ইনস্টল ও ব্যবহার করুন

শুরু করার সবচেয়ে নিরাপদ উপায় হলো Aurelio-র কাল্পনিক পরিবারের ডেটা ব্যবহার করা। এর মাধ্যমে নিজের আর্থিক তথ্য না দিয়েই ইন্টারফেসটি ঘুরে দেখতে পারবেন।

macOS ও Linux

git clone https://github.com/LosaLosSantos/aurelio-finance.git
cd aurelio-finance
./start.sh --demo

Windows PowerShell

git clone https://github.com/LosaLosSantos/aurelio-finance.git
cd aurelio-finance
./start.ps1 -Demo

PowerShell যদি জানায় যে স্ক্রিপ্ট চালানো নিষ্ক্রিয়, তাহলে execution-policy override দিয়ে স্ক্রিপ্টটি চালান:

powershell -ExecutionPolicy Bypass -File .\start.ps1 -Demo

প্রথমবার চালুর পর Aurelio http://localhost:8000-এ খুলবে। ডেমো পরিবারের তথ্য আলাদা ফাইলে রাখা হয়, তাই নিজের ডেটায় প্রভাব না ফেলেই এটি ঘুরে দেখতে পারবেন।

পোর্টফোলিও ও রেকর্ড দেখুন

পোর্টফোলিও ভিউতে বাজারদর অনুযায়ী মূল্যায়িত পজিশন এবং সেগুলোর খরচ, লাভ ও লভ্যাংশ দেখা যায়।

অন্তর্নিহিত বিশ্লেষণ ভিউতে ফান্ডগুলো কী ধারণ করে সে সম্পর্কে আরও বিস্তারিত তথ্য পাওয়া যায়। দেশ, খাত, কোম্পানি ও মুদ্রা অনুযায়ী এক্সপোজার পরীক্ষা করতে পারবেন।

রেকর্ডে পৃথক অ্যাকাউন্টের সময়-নির্দিষ্ট পরিস্থিতি অন্তর্ভুক্ত করা যায়। এর মাধ্যমে নির্দিষ্ট সময়ে আপনার কাছে কী ছিল তা উপস্থাপন করা সম্ভব।

নিজের ডেটা দিয়ে Aurelio ব্যবহার করুন

ডেমো ব্যবহারে স্বচ্ছন্দ হওয়ার পর অ্যাপ্লিকেশনটি বন্ধ করে ডেমো অপশন ছাড়া চালু করুন।

macOS ও Linux

./start.sh

Windows PowerShell

./start.ps1

আপনার রেকর্ড backend/data.db-এ সংরক্ষিত থাকে। কোনো আপডেটে ডেটাবেসের ফরম্যাট পরিবর্তনের সম্ভাবনা থাকলে পরিবর্তন প্রয়োগের আগে Aurelio ডেটাবেসের পাশে একটি কপি সংরক্ষণ করে।

এই অ্যাপ্লিকেশন আর্থিক তথ্য নিয়ে কাজ করে, তাই Aurelio যে কম্পিউটার ও ফোল্ডারে চলে সেগুলো সুরক্ষিত রাখুন। README-তে স্থানীয় সংরক্ষণ সম্পর্কে বলা আছে, তবে এতে কোনো হোস্ট করা সিঙ্ক্রোনাইজেশন বা ব্যাকআপ পরিষেবা নেই।

ঐচ্ছিক AI উপদেষ্টা সক্রিয় করুন

AI সুবিধাটি ঐচ্ছিক। কোনো AI প্রদানকারী কনফিগার না করেও স্থানীয় আর্থিক ব্যবস্থাপনার সুবিধাগুলো ব্যবহার করতে পারবেন।

1. OpenRouter-এ একটি অ্যাকাউন্ট তৈরি করে ক্রেডিট যোগ করুন।
2. OpenRouter Keys-এ একটি API key তৈরি করুন।
3. রিপোজিটরির রুট থেকে backend/.env.example কপি করে backend/.env তৈরি করুন।
4. backend/.env-এ OPENROUTER_API_KEY-এর মান নির্ধারণ করুন।

OPENROUTER_API_KEY=your_openrouter_key

পরিবেশ ফাইল পরিবর্তন করার পর Aurelio পুনরায় চালু করুন, যাতে অ্যাপ্লিকেশনটি নতুন কনফিগারেশন পড়তে পারে।

ডিফল্ট মডেল হলো Claude Opus 5.5, এবং আপনি চ্যাটে অন্য একটি মডেল বেছে নিতে পারেন। README-তে অক্টোবর 2026-এ পরিমাপ করা উদাহরণমূলক খরচ জানানো হয়েছে: এক রাউন্ডে উত্তর পাওয়া প্রথম প্রশ্নের জন্য প্রায় $0.11, এক রাউন্ডে উত্তর পাওয়া ফলো-আপের জন্য $0.017, একটি ওয়েব অনুসন্ধানসহ পরামর্শের জন্য $0.16, এবং একটি বিশ্লেষণের জন্য $0.33 থেকে $0.51। প্রকৃত খরচ ভিন্ন হতে পারে, তাই আপনার OpenRouter অ্যাকাউন্ট এবং নির্বাচিত মডেল পরীক্ষা করুন।

প্রশ্ন করুন এবং প্রস্তাবিত পরিবর্তন পর্যালোচনা করুন

API কী কনফিগার করা থাকলে, আপনার নিজস্ব রেকর্ডের ভিত্তিতে প্রশ্ন করতে চ্যাট ব্যবহার করুন। কোনো অনুরোধে বাইরের তথ্যের প্রয়োজন হলে Aurelio ওয়েব অনুসন্ধানও করতে পারে।

সহকারী কোনো পরিবর্তনের প্রস্তাব দিলে তা প্রয়োগের আগে পর্যালোচনা করুন। আপনার রেকর্ড নীরবে পরিবর্তন করার পরিবর্তে অ্যাপ্লিকেশনটি প্রস্তাবটিকে একটি কার্ড হিসেবে দেখায়, যা আপনি নিশ্চিত বা প্রত্যাখ্যান করতে পারেন।

আর্থিক তথ্যের ক্ষেত্রে এই নিশ্চিতকরণ ধাপটি বিশেষভাবে গুরুত্বপূর্ণ: গ্রহণ করার আগে প্রস্তাবিত অ্যাকাউন্ট, তারিখ, পরিমাণ বা অন্যান্য বিবরণ আপনার অভিপ্রায়ের সঙ্গে মেলে কি না যাচাই করুন।

ডেভেলপমেন্ট ও পরীক্ষা

আপনি যদি Aurelio-তেই কাজ করতে চান, প্রকল্পটিতে ব্যাকএন্ড ও ফ্রন্টএন্ডের জন্য আলাদা ওয়ার্কফ্লো রয়েছে।

ব্যাকএন্ড পরীক্ষা চালান

backend/ ডিরেক্টরি থেকে চালান:

uv run pytest

ফ্রন্টএন্ড পরীক্ষা চালান

frontend/ ডিরেক্টরি থেকে চালান:

npm test

হট রিলোড চালু করুন

ব্যাকএন্ডে হট রিলোড চালু করতে backend/-এর ভেতরে নিম্নলিখিত কমান্ডটি চালান:

uv run uvicorn app.main:app --port 8000

ফ্রন্টএন্ড ডেভেলপমেন্ট সার্ভারের জন্য frontend/-এর ভেতরে এই কমান্ডটি চালান:

npm run dev

ব্যবহারিক পরামর্শ

• ডেমো মোড দিয়ে শুরু করুন: ব্যক্তিগত রেকর্ড দেওয়ার আগে --demo অথবা -Demo ব্যবহার করুন।
• AI ঐচ্ছিক রাখুন: চ্যাট, ওয়েব-সহায়িত উত্তর বা বিশ্লেষণ চাইলে তবেই OpenRouter কনফিগার করুন।
• প্রতিটি প্রস্তাব পর্যালোচনা করুন: আপনার রেকর্ড পরিবর্তন করার আগে চ্যাটের কার্ডগুলো সতর্কতার সঙ্গে নিশ্চিত বা প্রত্যাখ্যান করুন।
• মডেলের খরচ নজরে রাখুন: নির্বাচিত মডেল ও অনুরোধের ধরন OpenRouter ব্যবহারে প্রভাব ফেলে।
• আপনার ডেটাবেস সংরক্ষণ করুন: backend/data.db এবং ফরম্যাট আপডেটের সময় Aurelio তৈরি করা কপিগুলোর হিসাব রাখুন।
• রিজনিং গাইড ব্যবহার করুন: নির্ধারিত ওয়ার্কফ্লো বুঝতে প্রকল্পটির বিশ্লেষণ কীভাবে কাজ করে সে সম্পর্কে দেওয়া ব্যাখ্যাটি পড়ুন।

উপসংহার

Aurelio স্থানীয় আর্থিক রেকর্ড সংরক্ষণকে ঐচ্ছিক AI সহায়তার সঙ্গে একত্র করে। রিপোজিটরি ক্লোন করুন, কল্পিত ডেমো পরিবারের ডেটা চালু করুন, পোর্টফোলিও ও লুক-থ্রু ভিউ দেখুন, তারপর নিজের ডেটার জন্য ডেমো মোড ছাড়া অ্যাপ্লিকেশনটি চালান। কথোপকথনভিত্তিক নির্দেশনা চাইলে একটি OpenRouter কী যোগ করুন এবং প্রতিটি প্রস্তাবিত পরিবর্তন গ্রহণের আগে পর্যালোচনা করুন। Aurelio MIT License-এর অধীনে প্রকাশিত।