No description

Python 50.7%
Makefile 49.3%

Find a file

ConYel 21c4d5b96d fix(update docs): change to correct codeberg repository		2026年04月08日 19:06:42 +02:00
members	feat(members): add singlerider setup	2026年04月08日 08:31:59 +10:00
tools	fix(update docs): change to correct codeberg repository	2026年04月08日 19:06:42 +02:00
.gitignore	chore: add .gitignore and remove tracked build artifacts	2026年04月08日 08:34:46 +10:00
LICENSE	feat: initial setup	2026年04月07日 13:59:17 +02:00
Makefile	feat: initial setup	2026年04月07日 13:59:17 +02:00
PLAN.md	feat: initial setup	2026年04月07日 13:59:17 +02:00
README.md	fix(update docs): change to correct codeberg repository	2026年04月08日 19:06:42 +02:00

README.md

Agent Config Tracker

Track and compare hardware/software configurations and agent implementations across team members.

For humans and AI agents. Read this file to understand the project.

Quick Start

git clone git@codeberg.org:TEAM/agent-setup-hashbangers.git
cd agent-setup-hashbangers
make install
make validate

Contributing Guide

Workflow

1. Sync → make sync
2. Branch → git checkout -b members/update-NAME
3. Edit → Update your files
4. Validate → make validate
5. Commit → git commit -m "feat(members): add NAME setup"
6. Push → git push -u origin HEAD
7. PR → Create on Codeberg

Commit Format

<type>(<scope>): <subject>
<body> (optional)

Types

Type	Use For
`feat`	New member config, feature
`fix`	Bug fix
`docs`	Documentation
`bench`	Benchmark results
`chore`	Maintenance, deps

Examples

git commit -m "feat(members): add alice GPU setup
- RTX 4090 24GB
- 45 tokens/sec"

Security Setup

# SSH Key (Ed25519)
ssh-keygen -t ed25519 -C "you@email.com"
# SSH signing (recommended for 2026)
git config --local gpg.format ssh
git config --local user.signingKey "$(cat ~/.ssh/id_ed25519.pub)"
git config --local commit.gpgsign true
# Test connection
ssh -T git@codeberg.org

Member Configuration Template

Copy to members/<username>.md:

# Member: <username>

| Field | Value |
|-------|-------|
| **Display Name** | |
| **Tags** | local, gpu |
| **Created** | YYYY-MM-DD |
## Hardware

| Component | Specification |
|-----------|---------------|
| **GPU** | RTX 4090 24GB |
| **CPU** | AMD Ryzen 9, 16 cores |
| **RAM** | 64 GB |
## Software

| Field | Value |
|-------|-------|
| **Framework** | OpenCode |
| **Model** | llama-3.1-70b |
| **Quantization** | Q4_K_M |
## Agent

| Field | Value |
|-------|-------|
| **Knowledge Base** | Custom |
| **Custom Tools** | tool1, tool2 |
## Metrics

| Metric | Value |
|--------|-------|
| Tokens/Second | 45.2 |
| Latency p50 | 23ms |
## Lessons

### What Works
- Local inference
### Tips
- Monitor VRAM

Benchmark Template

Copy to benchmarks/results/<username>-<name>.md:

# Benchmark: <name>

| Field | Value |
|-------|-------|
| **Member** | username |
| **Date** | YYYY-MM-DD |
| **Verified** | [x] |
## Metrics

| Metric | Value | Unit |
|--------|-------|------|
| Tokens/Second | 45.2 | t/s |
| Latency p50 | 23 | ms |
| Latency p95 | 450 | ms |
## Conditions

| Parameter | Value |
|-----------|-------|
| Model | llama-3.1-70b |
| Test Runs | 10 |

Decision Matrix

Use Case	Recommended	Why
Interactive chat	Low latency	p50 < 50ms
Code generation	High throughput	t/s > 50
Long documents	Large context	32K+
Budget constrained	Local quantized	cost = 0ドル

By Budget

Budget	Setup	Speed
0ドル	CPU + 7B Q4	30-50 t/s
500ドル	RTX 3060 12GB	30-50 t/s
1000ドル	RTX 4070 12GB	50-80 t/s
2000ドル	RTX 4090 24GB	60-120 t/s
100ドル/mo	Cloud A100	100-200 t/s

By Use Case

Use Case	Priority	Setup
Interactive chat	Latency	Local GPU
Code completion	Speed	RTX 3080+
Long documents	Context	32K+ model
Batch processing	Cost	Quantized
Production API	Reliability	Cloud

Complete Setup Guide

Prerequisites

Software	Version	Install
Git	2.40+	`apt install git`
Python	3.10+	`curl -LsSf https://astral.sh/uv/install.sh \| sh`

Step 1: Codeberg Account

Go to https://codeberg.org
Register → Verify email
Username becomes your repo prefix

Step 2: SSH Setup (2026 Best Practice)

# Generate Ed25519 key (faster, more secure than RSA)
ssh-keygen -t ed25519 -C "you@email.com" -f ~/.ssh/id_ed25519_codeberg
# Configure SSH
cat >> ~/.ssh/config << 'EOF'
Host codeberg.org
 HostName codeberg.org
 User git
 IdentityFile ~/.ssh/id_ed25519_codeberg
 IdentitiesOnly yes
EOF
# Add public key to Codeberg:
# Settings → SSH/GPG Keys → Add Key → paste id_ed25519_codeberg.pub
# Test
ssh -T git@codeberg.org

Step 3: Fork & Clone

# Fork on Codeberg (web UI), then:
git clone git@codeberg.org:YOUR_NAME/agent-setup-hashbangers.git
cd agent-setup-hashbangers 
# Add upstream (for sync)
git remote add upstream git@codeberg.org:TEAM/agent-setup-hashbangers.git

Step 4: Install Tools

make install

Step 5: Configure Git (Local Only)

# These are LOCAL to this repo only (.git/config)
# Identity
git config --local user.name "Your Name"
git config --local user.email "you@email.com"
# Signing (local - THIS REPO ONLY)
git config --local gpg.format ssh
git config --local user.signingKey "$(cat ~/.ssh/id_ed25519.pub)"
git config --local commit.gpgsign true
# Safety - prevent accidental force-push overwrites
git config --local forceWithLease.worker "git push --force-with-lease"
# Rebase by default for cleaner history
git config --local pull.rebase true
git config --local rebase.autostash true

Step 6: Configure Git Safety (Run Once)

# Or use the make target:
make configure-git

This sets (all LOCAL to this repo only):

pull.rebase true - cleaner history
rebase.autostash true - auto-stash before rebase
push.default current - push current branch
push.useForceIfIncludes true - prevents overwriting others' remote changes

Step 7: Commit & Push

git checkout -b members/add-YOURNAME
git add members/yourname.md
git commit -m "feat(members): add YOURNAME"
git push -u origin HEAD
# Create PR on Codeberg

Repository Settings (Codeberg)

Recommended Settings

Branches → Protect main:
- Require PR reviews: Yes
- Require signed commits: Yes
- Dismiss stale reviews: Yes
Collaborators:
- Add team members by username
- Permission: Write (for contributors)
Security:
- Enable wiki: No (using markdown files)
- Enable issues: Yes

Troubleshooting

"Permission denied (publickey)"

# Verify key
ssh -T git@codeberg.org
# Check with verbose
ssh -vvv git@codeberg.org

"gpg: signing failed"

# Use SSH signing instead
git config --local gpg.format ssh
git config --local user.signingKey "$(cat ~/.ssh/id_ed25519.pub)"

Validation errors

# Reinstall deps
make install
make validate

Resources

Topic	Link
Codeberg	https://codeberg.org
Codeberg Docs	https://docs.codeberg.org
llama.cpp	https://github.com/ggerganov/llama.cpp
vLLM	https://github.com/vllm-project/vllm
Ollama	https://github.com/ollama/ollama
LM Harness	https://github.com/EleutherAI/lm-evaluation-harness
Conventional Commits	https://www.conventionalcommits.org

Architecture Patterns

ReAct (Reasoning + Acting)

Thought → Action → Observation → repeat

Best for: Complex multi-step tasks

Chain-of-Thought

Input → Step 1 → Step 2 → Output

Best for: Math, logic, analysis

Tool Use

User → Model → [Tool] → Result → Output

Best for: External data, calculations

License

AGPL-3.0: Open source, free
Commercial: Contact for paid license

See LICENSE and LICENSE-COMMERCIAL.