🧮 junshi-ai-calc

AI-powered calculator driven by large language models. Input natural language, get calculated results.

✨ Features

• 🗣️ Natural Language Input - Type math problems in plain language (Chinese or English)
• 🤖 LLM-Powered - Uses DashScope (Qwen) to parse natural language into math expressions
• 🔒 Safe Calculation - Uses mathjs for secure expression evaluation (no eval!)
• 🎨 Beautiful UI - Styled welcome screen with borders and colors
• 🎉 Celebration Effects - Fun emoji celebrations after successful calculations
• 🔑 Interactive Setup - Easy API key configuration wizard

🚀 Installation

npm install -g junshi-ai-calc

🔑 Setup

Interactive Setup (Recommended)

junshi-ai-calc --config

Environment Variable

export DASHSCOPE_API_KEY="your-api-key-here"

Get your API Key from: https://dashscope.console.aliyun.com/

💬 Usage

Interactive Mode

$ junshi-ai-calc

Welcome Screen:

  ╔══════════════════════════════════════════════════════════════╗
  ║                                                              ║
  ║   🧮  AI Calculator                                         ║
  ║   Natural Language Math powered by LLM                      ║
  ║                                                              ║
     v1.2.0 • 2026-03-13                                             ║
  ╠══════════════════════════════════════════════════════════════╣
  ║                                                              ║
  ║   💡 开始使用：                                             ║
  ║                                                              ║
  ║   ● 123 乘以 456                                             ║
  ║   ● 求 1 加到 100 的和                                         ║
  ║   ● sin(30 度) 是多少                                        ║
  ║   ● 2 的 10 次方                                               ║
  ║                                                              ║
  ║   Commands: h(help) • q(quit) • clear(清屏) • config(配置)   ║
  ║                                                              ║
  ╚══════════════════════════════════════════════════════════════╝

  ┌──────────────────────────────────────────────────────────┐
  │ ❯ 123 乘以 456
  123 乘以 456
  ┃ = 56088
  🎉 ✨ 🎊

  ┌──────────────────────────────────────────────────────────┐
  │ ❯ q
  👋 再见！欢迎再次使用 AI Calculator

Single Expression Mode

$ junshi-ai-calc -e "100 加 200"
  = 300

Test Mode

$ junshi-ai-calc --test
  ╔══════════════════════════════════════╗
  ║  🧪 Running tests...                 ║
  ╚══════════════════════════════════════╝

  ✅ "123 乘以 456" => 56088
  ✅ "100 加 200" => 300
  ✅ "3 的平方" => 9
  ✅ "144 的平方根" => 12

  Result: 4 passed, 0 failed

📝 Examples

| Input | Output | |-------|--------| | 123 乘以 456 | 56088 | | 100 加 200 | 300 | | 3 的平方 | 9 | | 144 的平方根 | 12 | | sin(30 度) | 0.5 | | 5 的阶乘 | 120 | | 2 的 10 次方 | 1024 | | 求 1 加到 100 的和 | 5050 |

🎨 UI Features

• Styled Welcome Screen - Beautiful bordered box with version info
• Input Box - Clear visual separation for user input
• Celebration Effects - Emoji animations after successful calculations
• Color-coded Output - Green for success, red for errors
• Help Commands - Built-in help and examples

🔧 Commands

| Command | Description | |---------|-------------| | h, help | Show help | | q, quit, exit | Exit program | | clear, cls | Clear screen | | config | Reconfigure API Key |

📄 License

MIT

🙏 Acknowledgments

• Powered by DashScope (通义千问)
• Uses mathjs for safe calculation