Inspiration

Many African small businesses, field teams, community groups, and local operators manage important work using notebooks, spreadsheets, exported CSV files, SMS records, and offline documents. When internet is unreliable or data is sensitive, cloud AI tools are not always practical.

Kazi Agent was inspired by the need for a useful AI assistant that can run locally on ordinary laptops and help people organize work without sending private records to the cloud.

What it does

Kazi Agent is an offline autonomous workflow agent for African SMEs and field workers. It is designed to turn local operational records into:

  • prioritized action plans
  • short follow-up message drafts
  • risk summaries
  • missing-information checks
  • next steps that require human approval The agent focuses on practical workflows such as customer follow-ups, community collections, field operations, and small business task planning.

How we are building it

The project is being built for the ADTC 2026 Laptop LLM Challenge with a local-first design.

The submission uses the official ADTC structure with metadata.json, download_model.sh, REPORT.md, and a GGUF model path. The planned runtime is llama.cpp with a small quantized GGUF model suitable for low-resource laptops. The first planned model is Qwen2.5-1.5B-Instruct Q4_K_M because it offers a balance between instruction-following quality, multilingual support, and efficiency for an 8GB RAM laptop target.

Offline and privacy design

Kazi Agent does not depend on cloud inference. The goal is for users to keep their records on their own machine while the agent processes tasks locally. The agent does not automatically send messages or take external actions. Instead, it produces draft outputs and marks actions that require human review.

Why it matters

Many teams across Africa work in low-connectivity environments and still need reliable tools for planning, follow-ups, and local decision support. Kazi Agent is designed for those environments: it keeps data local, works toward low-resource laptop compatibility, and produces human-reviewable outputs instead of taking risky actions automatically.

Current progress

Kazi Agent now includes a runnable offline MVP. The repository includes run_kazi_agent.sh and examples/shop_records.txt, allowing the agent to process local SME records through llama-completion and the local GGUF model.

The MVP produces a brief status summary, prioritized action plan, draft follow-up messages, risks or missing information, and a human approval checklist. This strengthens the project from a profiler-ready submission into a working offline autonomous workflow prototype.

Built With

  • autonomous-agents
  • gguf
  • llama.cpp
  • localllm
  • offline-ai
  • python
  • qwen2.5
  • ubuntu
Share this project:

Updates

posted an update

Sample offline MVP output added

Kazi Agent now includes a sample input and output workflow in the public repository.

The new files show how the offline MVP processes local SME records:

  • examples/shop_records.txt — sample local business records
  • examples/sample_output.md — generated workflow output

The sample output includes a status summary, prioritized action plan, draft follow-up messages, risks or missing information, and a human approval checklist. The checklist makes clear that messages and actions should be reviewed, approved, edited, or rejected by a human before use.

GitHub: https://github.com/ezekiellemana/kazi-agent-adtc

Log in or sign up for Devpost to join the conversation.

posted an update

Runnable offline MVP added

Kazi Agent now has a working offline MVP.

The new run_kazi_agent.sh script runs local inference through llama-completion using the downloaded GGUF model. A sample file, examples/shop_records.txt, demonstrates how the agent can turn local SME records into:

  • a brief status summary
  • prioritized action steps
  • draft follow-up messages
  • risks or missing information
  • a human approval checklist

No cloud APIs are used, and model weights remain excluded from GitHub.

Log in or sign up for Devpost to join the conversation.

posted an update

Kazi Agent initial profiler milestone

Kazi Agent has reached its first local ADTC profiler milestone.

The project now has:

  • a public ADTC-compatible GitHub repository
  • a GGUF model downloader for Qwen2.5-1.5B-Instruct Q4_K_M
  • llama.cpp running locally in Ubuntu WSL
  • an initial participant profiler run

Initial local results:

  • 31.32 tokens/sec
  • 1818.32 MB peak RSS
  • no throttling detected

Next step: finalize the demo video and continue improving the offline autonomous workflow experience.

Log in or sign up for Devpost to join the conversation.