sudhanva for Ruby

Minimal, dependency-free Ruby client for the public sudhanva.me API. It retrieves published profile and article metadata, performs bounded batch reads, searches the published site, and creates or polls temporary profile-insight jobs.

The API is public and requires no credentials. Do not send private data.

Install

gem install sudhanva

Or add it to a Gemfile:

gem "sudhanva", "~> 0.1"

Use

require "sudhanva"

client = Sudhanva::Client.new

profile = client.profile
posts = client.posts(limit: 5, tag: "kubernetes")
article = client.post("making-your-site-agent-friendly")

job = client.create_profile_insight(
  audience: "hiring-manager",
  focus: ["production-ml", "inference"],
  idempotency_key: "my-workflow-2026-08-23"
)
result = client.wait_for_profile_insight(job["job_id"])

All methods return decoded JSON hashes. Non-success responses raise Sudhanva::APIError with status, code, and the decoded response body.

API coverage

• profile
• posts and post
• batch
• create_profile_insight, profile_insight, and wait_for_profile_insight
• ask for NLWeb conversational search

The client follows the stable /api/v1 contract. See the developer documentation and versioning policy.

Development

bundle install
bundle exec rake test
gem build sudhanva.gemspec

The test suite uses an injected transport and never calls production.

License

MIT