Skip to content

Commit 88cd225

Browse files
committed
Make the guided installer route prominent in README and GitHub Pages
Both README.md and docs/index.html led with "clone the repo and ask Claude Code" as the first, primary route, with the guided installer mentioned second -- backwards from what v0.1.0-beta.4 actually offers most people. Reorder both so downloading Socials Studio is the primary route and the repository/clone route is clearly secondary, matching the button hierarchy and wording already approved on https://solvx.uk/socials-studio. README.md: - New "Download Socials Studio" section right after the intro, linking solvx.uk/socials-studio prominently plus direct v0.1.0-beta.4 asset links for Windows/macOS/Linux. - "Get started" reordered: guided installer first, "Already use Claude Code" second, with the literal clone/cd/claude three-line route. - Testing status corrected: the beta.3 Windows installer was actually human-tested successfully (existing Claude Code detection and launch confirmed) -- the freshly built beta.4 binary hasn't had its own separate hardware retest yet. Noted Linux's real-Chrome (not Chromium) requirement inline. - All beta.2/beta.3 version references updated to beta.4 where they describe the current download. docs/index.html: - Hero button row restructured: "Download for Windows" primary, macOS/ Linux downloads and a solvx.uk link secondary, GitHub-related buttons demoted further. - "Get started" section reordered to match (installer first, clone route second, with the same three-line code block), added an anchor id for the new "Install with Claude Code" button, and the same Windows/Linux testing-status and Chrome-requirement corrections as the README. - All beta.2 references (meta tags, JSON-LD, beta pill, section heading) updated to beta.4. No application code touched. All 107 tests still pass, compileall is clean, git diff --check is clean, and every download/release link in both files (including solvx.uk and all three beta.4 assets) returns HTTP 200.
1 parent 6746ce6 commit 88cd225

2 files changed

Lines changed: 129 additions & 91 deletions

File tree

README.md

Lines changed: 67 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -12,17 +12,43 @@ Tell it what you want -- a topic, a product shot, a finished video, or a rendere
1212
[OpenMontage](https://github.com/calesthio/OpenMontage) project -- and Socials Studio writes
1313
platform-specific posts for **YouTube, X, Bluesky, LinkedIn, and Instagram**, adapts each one to
1414
that platform's own conventions, and publishes only once you've reviewed and confirmed it.
15-
[Claude Code](https://claude.com/claude-code) is what actually does the writing, coordinating, and
16-
publishing -- Socials Studio is the local toolkit and set of skills it uses to do that safely.
15+
[Claude Code](https://claude.com/claude-code) is what operates the tools -- it does the writing,
16+
coordinating, and publishing -- and nothing is ever published without your explicit approval.
17+
Socials Studio is the local toolkit and set of skills Claude Code uses to do that safely.
1718

1819
> Socials Studio is an independent community project, not affiliated with, maintained by, or
1920
> endorsed by OpenMontage. It works just as well with any other video, image, or idea.
2021
21-
**Public beta — v0.1.0-beta.2.** Guided installers for Windows, macOS, and Linux are on the way
22-
(see [Get started](#get-started) below); this beta has been developed and tested with Claude Code
23-
-- see [Testing status](#testing-status) before pointing it at a real account.
22+
**Public beta — v0.1.0-beta.4.** Guided installers for Windows, macOS, and Linux are here (see
23+
[Get started](#get-started) below); this beta has been developed and tested with Claude Code --
24+
see [Testing status](#testing-status) before pointing it at a real account.
2425

25-
---
26+
## Download Socials Studio
27+
28+
**[Download Socials Studio](https://solvx.uk/socials-studio)** -- the guided download experience,
29+
with an installer for each operating system and no GitHub or Git required.
30+
31+
Or grab **v0.1.0-beta.4** directly from GitHub Releases:
32+
33+
- **Windows (recommended):** [`Socials-Studio-Setup.exe`](https://github.com/tradewithmeai/socials-studio/releases/download/v0.1.0-beta.4/Socials-Studio-Setup.exe)
34+
-- no GitHub, Git, or existing Python installation needed; Python is set up for you
35+
automatically. The installer isn't code-signed yet, so Windows may show a SmartScreen
36+
"unrecognized publisher" warning -- that's expected for now.
37+
- **macOS:** [`Socials-Studio-macOS.zip`](https://github.com/tradewithmeai/socials-studio/releases/download/v0.1.0-beta.4/Socials-Studio-macOS.zip)
38+
-- needs a system Python 3.10+ already present.
39+
- **Linux:** [`Socials-Studio-Linux.tar.gz`](https://github.com/tradewithmeai/socials-studio/releases/download/v0.1.0-beta.4/Socials-Studio-Linux.tar.gz)
40+
-- needs a system Python 3.10+ already present, and real Google Chrome (not Chromium --
41+
`chromium`/`chromium-browser` aren't supported; the design depends on real Chrome).
42+
43+
Either way, you'll still need [Claude Code](https://claude.com/claude-code) access and to sign in
44+
with a qualifying Claude account -- the installer can't do that part for you, and it never touches
45+
your social media accounts, logs in anywhere, or publishes anything during setup. See
46+
[Testing status](#testing-status) below for exactly what's been verified on each platform before
47+
pointing it at a real account.
48+
49+
Prefer the full walkthrough, checksums, and platform-by-platform detail? Use the
50+
[Releases page](https://github.com/tradewithmeai/socials-studio/releases/tag/v0.1.0-beta.4) or
51+
[solvx.uk/socials-studio](https://solvx.uk/socials-studio).
2652

2753
## Get started
2854

@@ -31,53 +57,39 @@ without Claude Code, since Claude is what actually reads your request, writes th
3157
the publishers. Two ways to get set up, both ending in the same place: a working Claude Code
3258
session, open in this project, ready to talk to.
3359

34-
### Already use Claude Code? Just ask it.
60+
### New to all this? Use the guided installer.
3561

36-
If you already have [Claude Code](https://claude.com/claude-code) installed and signed in, open a
37-
terminal anywhere and say:
62+
This is the [Download Socials Studio](#download-socials-studio) section above -- download the
63+
installer for your operating system and run it, no GitHub account or Git required on any platform.
64+
The installer copies the project onto your machine, checks for
65+
[Claude Code](https://claude.com/claude-code) and Google Chrome, and prepares the Python
66+
environment Socials Studio runs in. If Claude Code isn't found, it offers to install it for you --
67+
on Windows, as an unchecked opt-in checkbox on the installer's own finish page (via WinGet if
68+
available, otherwise Anthropic's official installer, and only if you check the box); on
69+
macOS/Linux, as a yes/no prompt in the terminal. Declining either is fine -- the Socials Studio
70+
launcher is installed either way, and Claude Code is still required before you can use it. This
71+
project never bundles or redistributes Claude Code itself; it only offers to run Anthropic's own
72+
official installer, and only with your explicit say-so. It finishes by opening a Socials Studio
73+
launcher; the first time you run it, Claude introduces itself, explains what it can do, and offers
74+
to walk you through connecting your first platform.
3875

39-
> "Clone `https://github.com/tradewithmeai/socials-studio` and set it up for me."
76+
### Already use Claude Code? Install via the repository instead.
4077

41-
Claude will clone the repository, explain each setup step before running it (a Python virtual
42-
environment, dependencies, a health check), and wait for your yes each time -- nothing happens
43-
silently. No separate installer needed for this route.
78+
The secondary, technical route -- clone the repository and let Claude Code set it up:
4479

45-
### New to all this? Use the guided installer.
80+
```bash
81+
git clone https://github.com/tradewithmeai/socials-studio.git
82+
cd socials-studio
83+
claude
84+
```
85+
86+
Once Claude Code is open in the project, just ask it to set things up -- for example:
87+
88+
> "Set this project up for me."
4689
47-
Download the installer for your operating system and run it -- no GitHub account or Git required
48-
on any platform:
49-
50-
- **Windows:** `Socials-Studio-Setup.exe` -- Python is set up for you automatically, no Python
51-
knowledge needed.
52-
- **macOS:** `Socials-Studio-macOS.zip` (unzip, then run `install.sh`) -- needs a system Python
53-
3.10+ already present (common on modern Macs); the installer checks the real version, not just
54-
a filename, and tells you exactly how to get one if it's missing.
55-
- **Linux:** `Socials-Studio-Linux.tar.gz` (extract, then run `install.sh`) -- same Python
56-
requirement and version check as macOS.
57-
58-
Grab the latest from the [Releases page](https://github.com/tradewithmeai/socials-studio/releases).
59-
The installer copies the project onto your machine, checks for [Claude Code](https://claude.com/claude-code)
60-
and Google Chrome, and prepares the Python environment Socials Studio runs in. If Claude Code
61-
isn't found, it offers to install it for you -- on Windows, as an unchecked opt-in checkbox on
62-
the installer's own finish page (via WinGet if available, otherwise Anthropic's official
63-
installer, and only if you check the box); on macOS/Linux, as a yes/no prompt in the terminal.
64-
Declining either is fine -- the Socials Studio launcher is installed either way, and Claude Code
65-
is still required before you can use it. This project never bundles or redistributes Claude Code
66-
itself; it only offers to run Anthropic's own official installer, and only with your explicit
67-
say-so. It finishes by opening a Socials Studio launcher; the first time you run it, Claude
68-
introduces itself, explains what it can do, and offers to walk you through connecting your first
69-
platform.
70-
71-
You'll still need to sign in to Claude with a qualifying account -- the installer can't do that
72-
part for you, and it never touches your social media accounts, logs in anywhere, or publishes
73-
anything during setup.
74-
75-
*(See [Testing status](#testing-status) below for exactly what's been verified on each platform --
76-
none of the three is claimed as fully verified yet. The Windows installer is unsigned for now, so
77-
Windows may show an "unrecognized publisher" warning; that's expected until this project has a
78-
code-signing certificate.)*
79-
80-
---
90+
Claude will explain each setup step before running it (a Python virtual environment, dependencies,
91+
a health check) and wait for your yes each time -- nothing happens silently. No separate installer
92+
needed for this route.
8193

8294
## What this is
8395

@@ -227,10 +239,14 @@ platform coverage, but it is not the same as a person installing this on their o
227239
actually launching Socials Studio. Do not read any of the three as fully verified until that's
228240
happened:
229241

230-
- **Windows:** automated build and installation tested; awaiting human test on a normal Windows
231-
machine.
242+
- **Windows:** the `v0.1.0-beta.3` installer was installed and launched successfully on a real
243+
Windows 11 machine -- existing Claude Code detection and launch into Socials Studio were
244+
confirmed. The optional "install Claude Code for me" route has passed automated Windows CI
245+
testing, but hasn't yet been tested by a person on a machine without Claude Code already
246+
installed. The newly built `v0.1.0-beta.4` binary hasn't received a separate human hardware
247+
retest of its own yet.
232248
- **Linux:** installer mechanics tested on Ubuntu 24.04 x64; real Chrome/account publishing not
233-
tested through this package.
249+
tested through this package. Requires real Google Chrome, not Chromium.
234250
- **macOS:** automated runner test only; no human hardware test received.
235251

236252
If you try any of these on real hardware, a [beta test report](#reporting-problems--requesting-features)

0 commit comments

Comments
 (0)