{"_id":"@aman_asmuei/aman-showcase","_rev":"2-dd80a983c41de624ce1b85f1580bb1fb","name":"@aman_asmuei/aman-showcase","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@aman_asmuei/aman-showcase","version":"0.1.0","keywords":["aman","ai-companion","showcase","telegram","discord"],"author":{"name":"Aman Asmuei"},"license":"MIT","_id":"@aman_asmuei/aman-showcase@0.1.0","maintainers":[{"name":"aman_asmuei","email":"amanasmuei@gmail.com"}],"homepage":"https://github.com/amanasmuei/aman-showcase#readme","bugs":{"url":"https://github.com/amanasmuei/aman-showcase/issues"},"bin":{"aman-showcase":"bin/aman-showcase.js"},"dist":{"shasum":"8deb2b3d9bc770837cb35b195e6a2a6512ba41a7","tarball":"https://registry.npmjs.org/@aman_asmuei/aman-showcase/-/aman-showcase-0.1.0.tgz","fileCount":199,"integrity":"sha512-PgNW5EWEOWkSNKSjsffjv2e61jU+6uScYL3F4G0oUBExT1nO/gs11Cs3krzbxVJX9wdvBN+58m6JwE/sb6fhdQ==","signatures":[{"sig":"MEUCIGs530KRqXjexk7i3NcqemDSuebBaag00f9SB1lXlH6gAiEA96YzqBdX8RR8qVG22yw/NgA0nZfKMn2JB78uSexo9cs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":583591},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"7ff2d23f128ac2b36eb5897c7ff4db59fd9d5f9a","scripts":{"dev":"tsup --watch","lint":"tsc --noEmit","test":"vitest run","build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"aman_asmuei","email":"amanasmuei@gmail.com"},"repository":{"url":"git+https://github.com/amanasmuei/aman-showcase.git","type":"git"},"_npmVersion":"10.9.4","description":"Real-world AI companion showcases — zero-code, configuration-only","directories":{},"_nodeVersion":"22.22.1","dependencies":{"picocolors":"^1.1.1","@clack/prompts":"^0.9.1"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aman-showcase_0.1.0_1774913238310_0.279184885641117","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@aman_asmuei/aman-showcase","version":"0.2.0","description":"Real-world AI companion showcases — zero-code, configuration-only","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"aman-showcase":"bin/aman-showcase.js"},"scripts":{"build":"tsup","dev":"tsup --watch","test":"vitest run","lint":"tsc --noEmit","prepublishOnly":"npm run build"},"keywords":["aman","ai-companion","showcase","telegram","discord"],"author":{"name":"Aman Asmuei"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/amanasmuei/aman-showcase.git"},"engines":{"node":">=18"},"dependencies":{"@clack/prompts":"^0.9.1","picocolors":"^1.1.1"},"devDependencies":{"@types/node":"^22.0.0","tsup":"^8.4.0","typescript":"^5.7.0","vitest":"^3.0.0"},"_id":"@aman_asmuei/aman-showcase@0.2.0","gitHead":"d69f9811e5b8d15dd12a5b9c436b566919e2186e","bugs":{"url":"https://github.com/amanasmuei/aman-showcase/issues"},"homepage":"https://github.com/amanasmuei/aman-showcase#readme","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-1UxS+Pzajf5mBw+c3bWZKUTahhVfxBSnCOuWKPu1eiLzQQJPgFPtgR+3tzqtXL9ZqaAkRFX4l9ZkxzWNiHTtdw==","shasum":"559e1e3d7c053ac562fb2b2e3f0b05f538cfd9ff","tarball":"https://registry.npmjs.org/@aman_asmuei/aman-showcase/-/aman-showcase-0.2.0.tgz","fileCount":199,"unpackedSize":583994,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEZElb53u3osBh9Zn9GoY1rrDKoxYby/3rbop+CJwmcnAiBQFg7gvyhXKrxZoNlQom4fkELb+dn5QOG1/8EBQblHHA=="}]},"_npmUser":{"name":"aman_asmuei","email":"amanasmuei@gmail.com"},"directories":{},"maintainers":[{"name":"aman_asmuei","email":"amanasmuei@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aman-showcase_0.2.0_1775303082071_0.6659340396027424"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-30T23:27:18.204Z","modified":"2026-04-04T11:44:42.331Z","0.1.0":"2026-03-30T23:27:18.553Z","0.2.0":"2026-04-04T11:44:42.221Z"},"bugs":{"url":"https://github.com/amanasmuei/aman-showcase/issues"},"author":{"name":"Aman Asmuei"},"license":"MIT","homepage":"https://github.com/amanasmuei/aman-showcase#readme","keywords":["aman","ai-companion","showcase","telegram","discord"],"repository":{"type":"git","url":"git+https://github.com/amanasmuei/aman-showcase.git"},"description":"Real-world AI companion showcases — zero-code, configuration-only","maintainers":[{"name":"aman_asmuei","email":"amanasmuei@gmail.com"}],"readme":"<div align=\"center\">\n\n# aman-showcase\n\n### Real-world AI companions built with zero code\n\n[![Showcases](https://img.shields.io/badge/showcases-13-blueviolet)](https://github.com/amanasmuei/aman-showcase)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![aman ecosystem](https://img.shields.io/badge/powered%20by-aman%20ecosystem-blue)](https://github.com/amanasmuei/aman)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/amanasmuei/aman-showcase/pulls)\n\n**Build intelligent AI companions using just markdown files.**<br>\nNo TypeScript. No JavaScript. No application code.\n\n[Browse Showcases](#showcases) · [Quick Start](#-quick-start) · [Build Your Own](#-build-your-own) · [Contributing](CONTRIBUTING.md)\n\n---\n\n**13 domains. 160+ files. 0 lines of code.**\n\n</div>\n\n## Showcases\n\n| | Showcase | Domain | What it does | Highlights |\n|---|---------|--------|-------------|------------|\n| 🇲🇾 | **[Bahasa](./bahasa/)** | Language Learning | AI tutor for Malay/English that never forgets your progress | `10 lessons` `80 words` |\n| 📖 | **[Quran](./quran/)** | Spiritual Growth | Understand what you recite — Quranic Arabic vocabulary | `12 lessons` `60 words` `20 roots` |\n| 💪 | **[Fitness](./fitness/)** | Health & Wellness | Personal trainer that tracks every workout | `4-week program` `30+ exercises` |\n| 💼 | **[Freelancer](./freelancer/)** | Business | Never let an invoice slip through the cracks | `7 workflows` `6 templates` |\n| 👥 | **[Team](./team/)** | Collaboration | Your team's memory — standups, decisions, onboarding | `7 workflows` `group bot` |\n| 💰 | **[Money](./money/)** | Personal Finance | Know where every ringgit goes — track, budget, save | `7 workflows` `budget tools` |\n| 🏪 | **[Kedai](./kedai/)** | Small Business | Digital partner for any kedai — makan, gunting, dobi, and more | `7 workflows` `8 business types` |\n| 📰 | **[Feed](./feed/)** | Personalized News | Your AI that knows what you care about — signal, not noise | `6 workflows` `learns interests` |\n| 🎧 | **[Support](./support/)** | Customer Support | Support that remembers every interaction | `7 workflows` `smart escalation` |\n| 👁️ | **[Monitor](./monitor/)** | Automation | AI watchdog that never sleeps — alerts, digests, trends | `7 workflows` `always-on` |\n| 💊 | **[Rutin](./rutin/)** | Health & Family | Never miss your ubat — medication reminders for you and parents | `6 workflows` `family mode` |\n| 📡 | **[IoT](./iot/)** | Smart Environment | AI-powered sensor monitoring — smart home, farm, aquaculture | `7 workflows` `ESP32 + RPi` |\n| 🕌 | **[Muslim](./muslim/)** | Islamic Daily | Prayer times, Hadith 40, dhikr, du'a, qiblat — your ibadah companion | `7 workflows` `40 hadith` |\n\n> **Want a showcase for your domain?** [See ideas](CONTRIBUTING.md#showcase-ideas) or [build one yourself](CONTRIBUTING.md#creating-a-new-showcase)!\n\n## What Makes This Different\n\nEvery AI chatbot forgets you. You explain your context, get help, close the chat — and tomorrow it starts from zero.\n\n**aman-showcase companions remember.** They know your vocabulary, your workout history, your clients, your team's decisions. They pick up exactly where you left off. Every single time.\n\nThis is possible because each showcase plugs into the [aman ecosystem](https://github.com/amanasmuei/aman) — a modular framework that gives AI companions persistent memory, identity, workflows, guardrails, and skills.\n\n**And the best part?** You don't write a single line of code. Each showcase is just a folder of markdown files.\n\n## How It Works\n\n```\nshowcase/\n├── identity/core.md          → Who the AI is (personality, style, values)\n├── workflows/flow.md         → What it does step-by-step\n├── rules/rules.md            → What it must/must not do\n├── skills/*.md               → Domain expertise it draws from\n├── content/                  → Domain-specific material\n└── config/setup.sh           → One-command setup\n```\n\nThe aman ecosystem provides everything else:\n\n```\n┌─────────────────────────────────────────────────┐\n│              Your Showcase                       │\n│       (just markdown files + content)            │\n└──────────────────────┬──────────────────────────┘\n                       │ plugs into\n        ┌──────────────┼──────────────┐\n        ▼              ▼              ▼\n   ┌─────────┐   ┌──────────┐   ┌─────────┐\n   │  acore  │   │   amem   │   │  aflow  │\n   │identity │   │ memory   │   │workflows│\n   └─────────┘   └──────────┘   └─────────┘\n        │              │              │\n   ┌─────────┐   ┌──────────┐   ┌─────────┐\n   │  arules │   │  askill  │   │  aeval  │\n   │  rules  │   │  skills  │   │  eval   │\n   └─────────┘   └──────────┘   └─────────┘\n                       │\n                ┌──────┴──────┐\n                ▼             ▼\n          ┌──────────┐  ┌─────────┐\n          │ Telegram │  │   Web   │\n          │  (bot)   │  │  (UI)   │\n          └──────────┘  └─────────┘\n```\n\n## Quick Start\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) v18+\n- A [Telegram](https://telegram.org/) account\n- An LLM API key — [Anthropic](https://console.anthropic.com/) (recommended), [OpenAI](https://platform.openai.com/), or free with [Ollama](https://ollama.com/)\n\n### 3 Steps\n\n```bash\n# 1. Clone and pick a showcase\ngit clone https://github.com/amanasmuei/aman-showcase.git\ncd aman-showcase/bahasa    # or: quran, fitness, freelancer, team\n\n# 2. Configure\ncp config/telegram.env.example .env\n# Edit .env → add your Telegram bot token + LLM API key\n\n# 3. Launch\nnpx @aman_asmuei/achannel add telegram\nbash config/setup.sh\nnpx @aman_asmuei/achannel serve\n```\n\n**That's it.** Message your bot on Telegram and start using it.\n\n<details>\n<summary><strong>How to get a Telegram bot token</strong></summary>\n\n1. Open Telegram and message [@BotFather](https://t.me/botfather)\n2. Send `/newbot` and follow the prompts\n3. Copy the token into your `.env` file\n4. For **Team** showcase: also send `/setprivacy` → select your bot → choose \"Disable\" (allows the bot to see group messages)\n\n</details>\n\n## Build Your Own\n\n**Anyone can create a new showcase — no coding required.**\n\n```bash\n# 1. Fork and create your folder\nmkdir my-showcase\n\n# 2. Write 4 markdown files\n#    identity/core.md     → personality\n#    workflows/flow.md    → what it does\n#    rules/rules.md       → guardrails\n#    skills/your-skill.md → domain knowledge\n\n# 3. Add content and config\n#    content/             → supporting material\n#    config/setup.sh      → copy from any existing showcase\n\n# 4. Test and PR\nbash config/setup.sh && npx @aman_asmuei/achannel serve\n```\n\nSee the full guide: **[CONTRIBUTING.md](CONTRIBUTING.md#creating-a-new-showcase)**\n\n### Showcase Ideas\n\n| Domain | Idea |\n|--------|------|\n| Mental Wellness | Mood journal + coping strategies |\n| Cooking | Recipe companion that learns your taste |\n| Parenting | Child development tracker |\n| Student | Study companion with spaced repetition |\n| Job Search | Application tracker + interview prep |\n| Garden | Plant care companion |\n\n## The Ecosystem\n\n<table>\n<tr>\n<td>\n\n| Package | What it does |\n|---------|-------------|\n| [**acore**](https://github.com/amanasmuei/acore) | AI identity — 25+ role archetypes |\n| [**amem**](https://github.com/amanasmuei/amem) | Persistent memory — SQLite + embeddings |\n| [**aflow**](https://github.com/amanasmuei/aflow) | Multi-step workflows |\n| [**arules**](https://github.com/amanasmuei/arules) | Safety guardrails |\n\n</td>\n<td>\n\n| Package | What it does |\n|---------|-------------|\n| [**askill**](https://github.com/amanasmuei/askill) | Domain expertise — 12 built-in |\n| [**aeval**](https://github.com/amanasmuei/aeval) | Relationship metrics |\n| [**achannel**](https://github.com/amanasmuei/achannel) | Telegram, Discord, Web |\n| [**aman-mcp**](https://github.com/amanasmuei/aman-mcp) | MCP server — IDE integration |\n\n</td>\n</tr>\n</table>\n\n## Contributing\n\nWe welcome contributions from everyone — **no coding required** for most contributions.\n\n| Contribution | Difficulty | Impact |\n|-------------|-----------|--------|\n| Fix content errors (translations, accuracy) | Easy | Very High |\n| Add lessons or templates | Easy-Medium | High |\n| Create a new showcase | Medium | Very High |\n| Fork Bahasa for a new language | Medium | Very High |\n| Test showcases end-to-end | Easy | High |\n\nSee the full guide: **[CONTRIBUTING.md](CONTRIBUTING.md)**\n\n## License\n\nMIT — use it, fork it, build with it.\n\n---\n\n<div align=\"center\">\n\n**Built with the [aman ecosystem](https://github.com/amanasmuei/aman)**\n\n*Give your AI a soul. Not just a prompt.*\n\n[GitHub](https://github.com/amanasmuei/aman-showcase) · [Report Issue](https://github.com/amanasmuei/aman-showcase/issues) · [Contribute](CONTRIBUTING.md)\n\n</div>\n","readmeFilename":"README.md"}