Ally is an AI-powered CLI tool designed to assist with anything from everyday tasks to complex projects.
This tool is best suited for scenarios where privacy is paramount and agentic capabilities are needed in the workflow, such as in scientific research or law firms.
A general-purpose agent that can:
Read, write, modify, and delete files and directories.
Access the internet.
Execute commands and code.
Note: Tools always ask for your permission before executing.
--create-project flag or the /project command in the default chat interface.Complete workflow:
In your chosen installation folder, open a terminal window and run:
git clone https://github.com/YassWorks/Ally.git
This file (located at Ally/) controls Ally's main settings and integrations. Example configuration:
{
"provider": "openai",
"provider_per_model": {
"general": "ollama",
"code_gen": "anthropic",
"brainstormer": null, // autofilled with 'openai'
"web_searcher": null // autofilled with 'openai'
},
"model": "gpt-4o",
"models": {
"general": "gpt-oss:20b",
"code_gen": "claude-sonnet-3.5",
"brainstormer": null, // autofilled with 'gpt-4o'
"web_searcher": null // autofilled with 'gpt-4o'
},
"temperatures": {
"general": 0.7,
"code_gen": 0,
"brainstormer": 1,
"web_searcher": 0
},
"system_prompts": { // leave as-is to use Ally's defaults
"general": null,
"code_gen": null,
"brainstormer": null,
"web_searcher": null
}
}
This file stores your API keys.
# Inference providers (only include those you need)
OPENAI_API_KEY=your_openai_api_key_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here
GOOGLE_GEN_AI_API_KEY=your_google_gen_ai_api_key_here
CEREBRAS_API_KEY=your_api_key_here
# Google Search API (if omitted, search tools will be limited)
GOOGLE_SEARCH_API_KEY=your_google_api_key_here
SEARCH_ENGINE_ID=your_search_engine_id_here
Steps:
.env.example) into .env.Depending on your OS choose either setup.cmd (Windows) or setup.sh (Linux/Mac)
Note: Ally creates its own virtual environment to keep dependencies isolated and automatically adds itself to your PATH.
Now you’re ready to run Ally from anywhere in the terminal using ally.
No comments yet.
Sign in to be the first to comment.