Skip to main content

HCAI

  • A lightweight AI command-line interface powered by Hack Club AI.

  • HCAI allows you to chat with multiple AI models directly from your terminal with streaming responses, persistent conversation history, and seamless model switching.

Story...

  • Well I wanted to use Claude and Codex together on same terminal but I don't know how to do it.
  • I found out OpenCode, installed it and tried to configure but HC blocks OpenCode.
  • So I though why not instead I build a dev tool and then HCAI was built.

Update

  • I updated the full README.
  • Well before I hardcoded the models available on Hack Club's AI website (stupid me). So now this code directly pull all the meta data of all the models via Hack Club's AI API keys.
  • Made a solid interactive terminal based frontend.
  • I got inspired from OpenCode and decided to make a frontend almost similar an AI chatbot.

What it does?

  • Basically you can switch between multiple AI Models so that you can use more than 1 AI models inside your terminal with JUST ONE COMMAND
  • So for example if you want to use Claude and Codex for Backend, Claude for Frontend, Codex for Bug Solving and Gemini for simple Q/A you can absolutely do that by switching between this 3 models bu just one command.
  • Well setup is also super simple, just past your Hack Club's AI API keys to it.
  • No hassle with configuration or any other stuff, just directly it starts and by simple commands you can switch between models.

Commands

  • This are commands:
Command Description
/help Show available commands
/use Switch AI model
/config Show current configuration
/clear Clear current conversation
/exit Exit HCAI
  • Well also you can use "/use ", so instead of query you write the name of AI Model for example you write Claude it will list all the Claude Models that Hack Club provides with their AI API keys.

Installation

  • Basically just use "pip install hcai" on your terminal since I published this on PyPi org.
  • You will get to setup it by just pasting you Hack Club's AI API key.

Run it locally?

Clone the repo

Install dependencies

  • pip install -r requirements.txt

Run HCAI

  • Run it via "py -m hcai.main" or "python -m hcai.main"

Release files for hcai 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hcai 1.0.2
File Size Uploaded
hcai-1.0.2.tar.gz 27.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hcai 1.0.2
File Interpreter ABI Platform
hcai-1.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 56.4 kB

Release files / hcai-1.0.2.tar.gz

Download URL hcai-1.0.2.tar.gz
Size 27.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c19b28fc750a5495421667b59f9bd6022b2d327a70ae569aa6977b4170aff984
BLAKE2b-256 checksum
How to use checksums
159ad052aec033c73236e37ffe736b563192e2755ddeda68c0bbf0e3c8e0cf92
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.15

Release files / hcai-1.0.2-py3-none-any.whl

Download URL hcai-1.0.2-py3-none-any.whl
Size 29.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
660f23a9149d448cbe8ae4bf14b5d16da4c7b0720b35b917df76a7a26c3fcd6c
BLAKE2b-256 checksum
How to use checksums
9ab9dc5a31e0c874a020b679e6142b3f7025f0fcd0d9b9c310904fed7c492e5a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.15

Release history Release notifications | RSS feed

1.0.4

2 release files

1.0.3

2 release files

This release

1.0.2 This release

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page